ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages
|
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 char-acter, character, acter, 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 |