Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

puts(3) [osx man page]

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

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

Check Out this Related Man Page

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

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)
Man Page

Featured Tech Videos