puts

Output a line to a stream

View other versions (4)

Contents

Interface
Description
Return Values
Errors
See Also
Standards
Page Comments

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:

Example - Output a line to a stream

Workings

#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;
}

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.

int	`fputs` (const char str, FILE stream)
int	`puts` (const char *str)