fputs(3) [osx man page]

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 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).

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

puts(3C)						   Standard C Library Functions 						  puts(3C)

NAME

       puts, fputs - put a string on a stream

SYNOPSIS

       #include <stdio.h>

       int puts(const char *s);

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

DESCRIPTION

       The  puts()  function  writes  the  string  pointed  to	by  s,	followed by a NEWLINE character, to the standard output stream stdout (see
       intro(3)). The terminating null byte is not written.

       The fputs() function writes the null-terminated string pointed to by s to the named output stream. The terminating null byte is	not  writ-
       ten.

       The  st_ctime and st_mtime fields of the file will be marked for update between the successful execution of fputs() and the next successful
       completion of a call to fflush(3C) or fclose(3C) on the same stream or a call to exit(2) or abort(3C).

RETURN VALUES

       On successful completion, both functions return the number of bytes written; otherwise they return EOF and set errno to indicate the error.

ERRORS

       Refer to fputc(3C).

USAGE

       Unlike puts(), the fputs() function does not write a NEWLINE character at the end of the string.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       exit(2), write(2), intro(3), abort(3C), fclose(3C), ferror(3C), fflush(3C), fopen(3C),  fputc(3C),  printf(3C),	stdio(3C),  attributes(5),
       standards(5)

SunOS 5.10							    18 Jun 2003 							  puts(3C)