CodeCogs

output a line to a stream

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

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 nonnegative integer on success and EOF on error.

ERRORS

EBADF

The \c stream argument is not a writable stream.

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

STANDARDS

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

fputs