Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

puts(3s) [hpux man page]

puts(3S)																  puts(3S)

NAME
puts(), fputs() - put a string on a stream SYNOPSIS
Obsolescent Interfaces DESCRIPTION
writes the null-terminated string pointed to by s, followed by a new-line character, to the standard output stream writes the null-terminated string pointed to by s to the named output stream, but does append a new-line character. Neither function writes the terminating null character. Notes and append a new-line character; and do not. Obsolescent Interfaces and put a string on a stream. RETURN VALUE
Upon successful completion, these routines return a non-negative number. Otherwise they return EOF, set the error indicator for the stream, and set to indicate the error. ERRORS
These routines fail if, either the stream is unbuffered or stream's buffer needed to be flushed causing an underlying call to be invoked, and: The flag is set for the file descriptor underlying stream and the process would be delayed in the write operation. The file descriptor underlying stream is not a valid file descriptor open for writing. An attempt was made to write to a file that exceeds the process's file size limit or the maximum file size (see ulimit(2)). A signal was caught during the system call. [EIO] The process is in a background process group and is attempting to write to its controlling terminal, is set, the process is neither ignoring nor blocking the signal, and the process group of the process is orphaned. There was no free space remaining on the device containing the file. An attempt is made to write to a pipe or FIFO that is not open for reading by any process. A signal is also sent to the process. Additional values may be set by the underlying function (see write(2)). WARNINGS
and are obsolescent interfaces supported only for compatibility with existing DCE applications. New multithreaded applications should use and SEE ALSO
ferror(3S), flockfile(3S), fopen(3S), fread(3S), printf(3S), putc(3S), orientation(5), thread_safety(5), glossary(9). STANDARDS CONFORMANCE
puts(3S)

Check Out this Related Man Page

putws(3C)																 putws(3C)

NAME
putws(), fputws() - put a wide character string on a stream file SYNOPSIS
Obsolescent Interfaces Remarks: is compliant with the XPG4 Worldwide Portability Interface wide-character I/O functions. These functions parallel the 8 bit character I/O functions defined in puts(3S). DESCRIPTION
writes a character string corresponding to the null-terminated wide-character string pointed to by ws followed by a new-line character, to the standard output stream writes a character string corresponding to the null-terminated wide-character string pointed to by ws to the named output stream, but does append a new-line character or a terminating null character. Neither function writes a terminating null character. The definition for these functions, the type and the value are provided in the header. Obsolescent Interfaces and put a wide character string on a stream file. APPLICATION USAGE
After or is applied to a stream, the stream becomes wide-oriented (see orientation(5)). EXTERNAL INFLUENCES
Locale The category determines how wide character conversions are done. International Code Set Support Single- and multi-byte character code sets are supported. RETURN VALUE
Upon successful completion, and return a non-negative number. Otherwise they return set the error indicator for the stream, and set to indicate the error. ERRORS
and fail if either the stream is unbuffered, or stream's buffer needed to be flushed causing an underlying call to be invoked, and: [EAGAIN] The flag is set for the file descriptor underlying stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write to a file that exceeds the process's file size limit or the maximum file size (see ulimit(2)). [EINTR] A signal was caught during the system call. [EIO] The process is in a background process group and is attempting to write to its controlling terminal, is set, the process is neither ignoring nor blocking the signal, and the process group of the process is orphaned. [ENOSPC] There was no free space remaining on the device containing the file. [EPIPE] An attempt is made to write to a pipe or FIFO that is not open for reading by any process. A signal is also sent to the process. [EILSEQ] A wide character in ws does not correspond to a valid character. Additional values may be set by the underlying function (see write(2)). WARNINGS
and are obsolescent interfaces supported only for compatibility with existing DCE applications. New multithreaded applications should use and AUTHOR
and were developed by OSF and HP. SEE ALSO
ferror(3S), flockfile(3S), fopen(3S), fread(3S), printf(3S), putwc(3C), orientation(5), thread_safety(5), glossary(9). STANDARDS CONFORMANCE
putws(3C)
Man Page