HP-UX Reference (11i v1 05/09) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

241

242

243

244

245

246

247

248

249

250

puts(3S) puts(3S)

NAME

puts(), fputs() - 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 new-line 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 new-line 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 non-negative 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 ﬂushed causing an

underlying write() call to be invoked, and:

[EAGAIN] The O_NONBLOCK ﬂag is set for the ﬁle descriptor underlying stream and the process

would be delayed in the write operation.

[EBADF] The ﬁle descriptor underlying stream is not a valid ﬁle descriptor open for writing.

[EFBIG] An attempt was made to write to a ﬁle that exceeds the process’s ﬁle size limit or the

maximum ﬁle 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 control-

ling 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 ﬁle.

[EPIPE] An attempt is made to write to a pipe or FIFO that is not open for reading by any pro-

cess. 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 new-line character; fputs() and fputs_unlocked()

do not.