annotate docs/ccguide/putc.refentry @ 588:e70529a05aca os9l1phoenix

Cleanup for Phoenix Release
author boisy
date Mon, 04 Nov 2002 22:28:30 +0000
parents d9ab3688bb71
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
1 <refentry id="putc">
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
2 <refnamediv>
573
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
3 <refname>Putc</refname>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
4 <refname>Putchar</refname>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
5 <refname>Putw</refname>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
6 <refpurpose>put character or word in a file</refpurpose>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
7 </refnamediv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
8
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
9 <refsynopsisdiv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
10 <funcsynopsis>
468
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
11 <funcsynopsisinfo>
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
12 #include &lt;stdio.h&gt;
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
13 </funcsynopsisinfo>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
14 <funcprototype>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
15 <funcdef><function>putc</function></funcdef>
573
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
16 <paramdef>char <parameter>ch</parameter></paramdef>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
17 <paramdef>FILE *<parameter>fp</parameter></paramdef>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
18 </funcprototype>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
19
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
20 <funcprototype>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
21 <funcdef><function>putchar</function></funcdef>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
22 <paramdef>char <parameter>ch</parameter></paramdef>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
23 </funcprototype>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
24
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
25 <funcprototype>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
26 <funcdef><function>putw</function></funcdef>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
27 <paramdef>int <parameter>n</parameter></paramdef>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
28 <paramdef>FILE *<parameter>fp</parameter></paramdef>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
29 </funcprototype>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
30 </funcsynopsis>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
31
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
32 </refsynopsisdiv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
33
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
34 <refsect1><title>Description</title>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
35 <para>
573
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
36 Putc add the character "ch" to the file "fp" at the current
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
37 writing position and advances the position pointer.
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
38 </para>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
39 <para>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
40 Putchar is implemented as a macro (defined in the header file)
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
41 and is equivalent to "putc(ch,stdout)".
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
42 </para>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
43 <para>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
44 Putw adds the (two byte) machine word "n" to the file "fp" in
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
45 the manner of putc.
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
46 </para>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
47 <para>
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
48 Output via putc is normally buffered except;
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
49 (a) when the buffering is disabled by "setbuf()", and
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
50 (b) the standard error output is always unbuffered.
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
51 </para>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
52 </refsect1>
542
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
53
552
fcb97f0ba24b All diagnostics added.
roug
parents: 542
diff changeset
54 <refsect1><title>Diagnostics</title>
fcb97f0ba24b All diagnostics added.
roug
parents: 542
diff changeset
55 <para>
fcb97f0ba24b All diagnostics added.
roug
parents: 542
diff changeset
56 Putc and putchar return the character argument from a
fcb97f0ba24b All diagnostics added.
roug
parents: 542
diff changeset
57 successful call, and EOF on end-of-file or error.
fcb97f0ba24b All diagnostics added.
roug
parents: 542
diff changeset
58 </para>
fcb97f0ba24b All diagnostics added.
roug
parents: 542
diff changeset
59 </refsect1>
fcb97f0ba24b All diagnostics added.
roug
parents: 542
diff changeset
60
542
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
61 <refsect1><title>See Also</title>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
62 <para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
63 <link linkend="fopen">fopen()</link>,
573
d9ab3688bb71 All function prototypes are added.
roug
parents: 552
diff changeset
64 <link linkend="fclose">fclose(), fflush()</link>,
542
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
65 <link linkend="getc">getc()</link>,
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
66 <link linkend="puts">puts()</link>,
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
67 <link linkend="printf">printf()</link>,
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
68 <link linkend="fread">fread()</link>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
69 </para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
70 </refsect1>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
71
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
72 </refentry>