Manpage of PUTC
PUTC
Section: NEWLIB (3)
Updated: 2005 Feb 23
Index
Return to Main Contents
NAME
3.31 `putc'--write a character (macro)
SYNOPSIS
#include <stdio.h>
int putc(int CH, FILE *FP);
DESCRIPTION
`putc' is a macro, defined in `stdio.h'. `putc' writes the argument CH
to the file or stream identified by FP, after converting it from an
`int' to an `unsigned char'.
If the file was opened with append mode (or if the stream cannot
support positioning), then the new character goes at the end of the
file or stream. Otherwise, the new character is written at the current
value of the position indicator, and the position indicator advances by
one.
For a subroutine version of this macro, see `fputc'.
RETURNS
If successful, `putc' returns its argument CH. If an error intervenes,
the result is `EOF'. You can use ``ferror(FP)'' to query for errors.
PORTABILITY
ANSI C requires `putc'; it suggests, but does not require, that `putc'
be implemented as a macro. The standard explicitly permits macro
implementations of `putc' to use the FP argument more than once;
therefore, in a portable program, you should not use an expression with
side effects as this argument.
Supporting OS subroutines required: `close', `fstat', `isatty',
`lseek', `read', `sbrk', `write'.
SEE ALSO
putc
is part of the
libc
library.
The full documentation for
libc
is maintained as a Texinfo manual. If
info
and
libc
are properly installed at your site, the command
-
info libc
will give you access to the complete manual.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURNS
-
- PORTABILITY
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 21:25:29 GMT, May 16, 2005
www.fiveanddime.net