NAME

putc, putchar, fputc, putw − put character or word on a stream

SYNOPSIS

#include <stdio.h>

int putc(c, stream)
char c;
FILE ∗stream;

putchar(c)

fputc(c, stream)
FILE ∗stream;

putw(w, stream)
FILE ∗stream;

DESCRIPTION

Putc appends the character c to the named output stream. It returns the character written.

Putchar(c) is defined as putc(c, stdout). 

Fputc behaves like putc, but is a genuine function rather than a macro.

Putw appends C int (word) w to the output stream. It returns the integer written. Putw neither assumes nor causes special alignment in the file. 

SEE ALSO

fopen(3S), fclose(3S), getc(3S), puts(3S), printf(3S), fread(3S)

DIAGNOSTICS

These functions return the constant EOF upon error.  Since this is a good integer, ferror(3S) should be used to detect putw errors. 

BUGS

Because it is implemented as a macro, putc treats a stream argument with side effects improperly.  In particular “putc(c, ∗f++)” doesn’t work sensibly. 

Errors can occur long after the call to putc.

Data files written and read with putw and getw are not portable; the size of an int and the order in which data bytes are stored within an int varies between machines. 

Sun System Release 1.0  —  23 August 1983