FreeBSD manual
download PDF document: fputs_unlocked.3.pdf
FPUTS(3) FreeBSD Library Functions Manual FPUTS(3)
NAME
fputs, fputs_unlocked, puts - output a line to a stream
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <stdio.h>
int
fputs(const char *str, FILE *stream);
int
fputs_unlocked(const char *str, FILE *stream);
int
puts(const char *str);
DESCRIPTION
The function fputs() writes the string pointed to by str to the stream
pointed to by stream.
The fputs_unlocked() function is equivalent to fputs(), except that the
caller is responsible for locking the stream with flockfile(3) before
calling it. This function may be used to avoid the overhead of locking
the stream and to prevent races when multiple threads are operating on
the same stream.
The function puts() writes the string str, and a terminating newline
character, to the stream stdout.
RETURN VALUES
The functions fputs() and puts() return a nonnegative integer on success
and EOF on error.
ERRORS
[EBADF] The stream argument is not a writable stream.
The functions fputs() and puts() may also fail and set errno for any of
the errors specified for the routines write(2).
SEE ALSO
ferror(3), fputws(3), putc(3), stdio(3)
STANDARDS
The functions fputs() and puts() conform to ISO/IEC 9899:1990
("ISO C90").
FreeBSD 14.0-RELEASE-p6 January 23, 2020 FreeBSD 14.0-RELEASE-p6