putc
output a character or word to a stream
You're viewing an older version of this page (#3269). View the current version.
NAME
<span class="Nm" id="fputc">fputc</span>, <span class="Nm" id="putc">putc</span>, <span class="Nm" id="putc_unlocked">putc_unlocked</span>, <span class="Nm" id="putchar">putchar</span>, <span class="Nm" id="putchar_unlocked">putchar_unlocked</span>, <span class="Nm" id="putw">putw</span>
INTERFACE
#include <stdio.h> int fputc ( int c, FILE *stream ) int putc ( int c, FILE *stream ) int putc_unlocked ( int c, FILE *stream ) int putchar ( int c ) int putchar_unlocked ( int c ) int putw ( int w, FILE *stream )
DESCRIPTION
The fputc function writes the character \c c (converted to an ``unsigned char'') to the output stream pointed to by \c stream. \n \n The putc macro acts essentially identically to fputc , but is a macro that expands in-line. It may evaluate \c stream more than once, so arguments given to putc should not be expressions with potential side effects. \n \n The putchar function is identical to putc with an output stream of <span class="Dv">stdout</span>. \n \n The putw function writes the specified <span class="Vt">int</span> to the named output \c stream. \n \n The putc_unlocked and putchar_unlocked functions are equivalent to putc and putchar respectively, except that the caller is responsible for locking the stream with reference:flockfile (3) before calling them. These functions may be used to avoid the overhead of locking the stream for each character, and to avoid output being interspersed from multiple threads writing to the same stream.
RETURN VALUES
The functions, fputc , putc , putchar , putc_unlocked and putchar_unlocked return the character written. If an error occurs, the value <span class="Dv">EOF</span> is returned. The putw function returns 0 on success; <span class="Dv">EOF</span> is returned if a write error occurs, or if an attempt is made to write a read-only stream.
SEE ALSO
ferror (3) , reference:flockfile (3) , fopen (3) , getc (3) , reference:putwc (3) , reference:stdio (3)
STANDARDS
The functions fputc , putc , and putchar , conform to The putc_unlocked and putchar_unlocked functions conform to A function putw function appeared in Version 6 AT&T UNIX
BUGS
The size and byte order of an <span class="Vt">int</span> varies from one machine to another, and putw is not recommended for portable applications.