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 call-
     ing  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  char-
     acter, 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 ports 15.1		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+15.1-RELEASE+and+Ports>

home | help