NAME

putc - put byte on a stream

SYNOPSIS

#include <stdio.h>

int putc(int c, FILE *stream);

DESCRIPTION

The putc() function is equivalent to fputc(), except that if it is implemented as a macro it may evaluate stream more than once, so the argument should never be an expression with side-effects.

RETURN VALUE

Refer to fputc().

ERRORS

Refer to fputc().

EXAMPLES

None.

APPLICATION USAGE

Because it may be implemented as a macro, putc() may treat a stream argument with side-effects incorrectly. In particular, putc(c, *f++) will not necessarily work correctly. Therefore, use of this interface is not recommended in such situations; fputc() should be used instead.

FUTURE DIRECTIONS

None.

SEE ALSO

fputc(), <stdio.h>.