HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)

p
puts(3S) puts(3S)
NAME
puts(), fputs(), puts_unlocked(), fputs_unlocked() - put a string on a stream
SYNOPSIS
#include <stdio.h>
int puts(const char *s);
int fputs(const char *s, FILE *stream);
Obsolescent Interfaces
int puts_unlocked(const char *s);
int fputs_unlocked(const char *s, FILE *stream);
DESCRIPTION
puts() writes the null-terminated string pointed to by s, followed by a newline character, to the stan-
dard output stream
stdout.
fputs() writes the null-terminated string pointed to by s to the named output stream, but does not
append a newline character.
Neither function writes the terminating null character.
Obsolescent Interfaces
puts_unlocked() and
fputs_unlocked() put a string on a stream.
RETURN VALUE
Upon successful completion, these routines return a nonnegative number. Otherwise they return EOF,
set the error indicator for the stream, and set
errno 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
write() call to be invoked, and:
[EAGAIN] The
O_NONBLOCK flag is set for the file descriptor underlying stream and the pro-
cess 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
write() system call.
[EIO] The process is in a background process group and is attempting to write to its con-
trolling terminal,
TOSTOP is set, the process is neither ignoring nor blocking the
SIGTTOU 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
SIGPIPE signal is also sent to the process.
Additional
errno values may be set by the underlying write() function (see write(2)).
WARNINGS
puts_unlocked() and fputs_unlocked() are obsolescent interfaces supported only for compati-
bility with existing DCE applications. New multithreaded applications should use
puts() and
fputs().
NOTES
puts() and puts_unlocked() append a newline character; fputs() and fputs_unlocked() do
not.
SEE ALSO
ferror(3S), flockfile(3S), fopen(3S), fread(3S), printf(3S), putc(3S), orientation(5), thread_safety(5).
Section 3−−828 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003