PUTC(3) | Library Functions Manual | PUTC(3) |
fputc
, putc
,
putchar
, putc_unlocked
,
putchar_unlocked
, putw
—
#include <stdio.h>
int
fputc
(int
c, FILE
*stream);
int
putc
(int
c, FILE
*stream);
int
putchar
(int
c);
int
putc_unlocked
(int
c, FILE
*stream);
int
putchar_unlocked
(int
c);
int
putw
(int
w, FILE
*stream);
fputc
() function writes the character
c (converted to an ``unsigned char'') to the output
stream pointed to by stream.
putc
() acts essentially identically to
fputc
(), but is a macro that expands in-line. It may
evaluate stream more than once, so arguments given to
putc
() should not be expressions with potential side
effects.
putchar
() is identical to
putc
() with an output stream of
stdout.
The putc_unlocked
() and
putchar_unlocked
() functions provide functionality
identical to that of putc
() and
putchar
(), respectively, but do not perform implicit
locking of the streams they operate on. In multi-threaded programs they may
be used only within a scope in which the stream has been
successfully locked by the calling thread using either
flockfile(3) or
ftrylockfile(3), and may
later be released using
funlockfile(3).
The putw
() function writes the specified
int to the named output stream.
fputc
(), putc
()
and putchar
() return the character written. If an
error occurs, the value EOF
is returned. The
putw
() function returns 0 on success;
EOF
is returned if a write error occurs, or if an
attempt is made to write a read-only stream.
fputc
(), putc
(),
and putchar
(), conform to ANSI
X3.159-1989 (“ANSI C89”). The functions
putc_unlocked
() and
putchar_unlocked
() conform to ISO/IEC
9945-1:1996 (“POSIX.1”).
putc
(), and putw
() functions
first appeared in Version 1 AT&T UNIX. The
putchar
() function first appeared in
Version 4 AT&T UNIX. The function
fputc
() appeared in Version 7
AT&T UNIX.
putw
() is not recommended for portable
applications.
September 2, 2019 | NetBSD 9.2 |