3 * Portions Copyright (c) 1990-1999 Nokia Corporation and/or its subsidiary(-ies).
8 * Copyright (c) 1990 The Regents of the University of California.
11 * Redistribution and use in source and binary forms are permitted
12 * provided that the above copyright notice and this paragraph are
13 * duplicated in all such forms and that any documentation,
14 * advertising materials, and other materials related to such
15 * distribution and use acknowledge that the software was developed
16 * by the University of California, Berkeley. The name of the
17 * University may not be used to endorse or promote products derived
18 * from this software without specific prior written permission.
19 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
20 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
21 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
26 <<putc>>---write a character (macro)
33 int putc(int <[ch]>, FILE *<[fp]>);
37 int putc(<[ch]>, <[fp]>)
42 <<putc>> is a macro, defined in <<stdio.h>>. <<putc>>
43 writes the argument <[ch]> to the file or stream identified by
44 <[fp]>, after converting it from an <<int>> to an <<unsigned char>>.
46 If the file was opened with append mode (or if the stream cannot
47 support positioning), then the new character goes at the end of the
48 file or stream. Otherwise, the new character is written at the
49 current value of the position indicator, and the position indicator
52 For a subroutine version of this macro, see <<fputc>>.
55 If successful, <<putc>> returns its argument <[ch]>. If an error
56 intervenes, the result is <<EOF>>. You can use `<<ferror(<[fp]>)>>' to
60 ANSI C requires <<putc>>; it suggests, but does not require, that
61 <<putc>> be implemented as a macro. The standard explicitly permits
62 macro implementations of <<putc>> to use the <[fp]> argument more than once;
63 therefore, in a portable program, you should not use an expression
64 with side effects as this argument.
66 Supporting OS subroutines required: <<close>>, <<fstat>>, <<isatty>>,
67 <<lseek>>, <<read>>, <<sbrk>>, <<write>>.
74 * A subroutine version of the macro putc.
80 putc (int c,register FILE *fp)
82 /* CHECK_INIT is (eventually) called by __swbuf. */
84 return __sputc (c, fp);