fputs(3)

fputs3

Output a line to a stream

Usage

#include <stdio.h>

int

fputs(const char *restrict s, FILE *restrict stream);

int

puts(const char *s);

Library

Standard C Library (libc, -lc)

Overview

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 functions fputs() and puts() return 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.

Releases

163 releases since Mac OS X 10.0; the text changed 4 times.

  1. 10.0–10.1.5
  2. 10.2–10.2.8
  3. 10.3–10.4.11
  4. 10.5–10.6.8
  5. 10.7–26.5

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.

From Libc 1752.120.2 in macOS 26.5. Parsed by carta from the page's mdoc source.