Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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	13.0		       January 23, 2020			  FreeBSD 13.0

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | STANDARDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=puts&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help