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

FreeBSD Manual Pages

  
 
  

home | help
FPUTS(3)		    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 suc-
       cess 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.3		       January 23, 2020			      FPUTS(3)

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

home | help