output a line to a stream

You're viewing an older version of this page (#3992). View the current version.

View versions (4)

INTERFACE

#include <stdio.h> int fputs ( 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 function puts writes the string str, and a terminating newline character to the stream stdout.

Example 1
Problem

Output a line to a stream

Workings

\code #include <stdio.h> int main() { // open text file for writing FILE *f = fopen("fred.txt", "wt"); if (f) { fputs("something", f); fclose(f); } return 0; } \endcode

RETURN VALUES

The fputs function returns 0 on success and EOF on error; puts returns a non-negative integer on success and EOF on error.

ERRORS

EBADF The \c stream argument is not a writable stream.
Blank

The functions fputs and puts may also fail and set errno for any of the errors specified for the write routine.

SEE ALSO

ferror, putc

STANDARDS

While not mentioned in the standard, both fputs and puts print (null) if str is NULL.