This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

FPUTS(3)                 BSD Library Functions Manual                 FPUTS(3)

NAME
     fputs, puts -- output a line to a stream

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <stdio.h>

     int
     fputs(const char *restrict s, FILE *restrict stream);

     int
     puts(const char *s);

DESCRIPTION
     The function fputs() writes the string pointed to by s to the stream pointed to by stream.

     The function puts() writes the string s, and a terminating newline character, to the stream stdout.

RETURN VALUES
     The fputs() function returns 0 on success and EOF on error; puts() returns 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).

COMPATIBILITY
     fputs() now returns a non-negative number (as opposed to 0) on successful completion.  As a result,
     many tests (e.g., "fputs() == 0", "fputs() != 0") do not give the desired result.  Use "fputs() != EOF"
     or "fputs() == EOF" to determine success or failure.

SEE ALSO
     ferror(3), fputws(3), putc(3), stdio(3)

STANDARDS
     The functions fputs() and puts() conform to ISO/IEC 9899:1990 (``ISO C90'').  While not mentioned in
     the standard, both fputs() and puts() print `(null)' if str is NULL.

BSD                              June 4, 1993                              BSD