comparison docs/ccguide/putc.refentry @ 573:d9ab3688bb71

All function prototypes are added.
author roug
date Fri, 01 Nov 2002 10:02:34 +0000
parents fcb97f0ba24b
children
comparison
equal deleted inserted replaced
572:e43a77fddcbd 573:d9ab3688bb71
1 <refentry id="putc"> 1 <refentry id="putc">
2 <refnamediv> 2 <refnamediv>
3 <refname>putc</refname> 3 <refname>Putc</refname>
4 <refpurpose>Placeholder</refpurpose> 4 <refname>Putchar</refname>
5 <refname>Putw</refname>
6 <refpurpose>put character or word in a file</refpurpose>
5 </refnamediv> 7 </refnamediv>
6 8
7 <refsynopsisdiv> 9 <refsynopsisdiv>
8 <funcsynopsis> 10 <funcsynopsis>
9 <funcsynopsisinfo> 11 <funcsynopsisinfo>
10 #include &lt;stdio.h&gt; 12 #include &lt;stdio.h&gt;
11 </funcsynopsisinfo> 13 </funcsynopsisinfo>
12 <funcprototype> 14 <funcprototype>
13 <funcdef><function>putc</function></funcdef> 15 <funcdef><function>putc</function></funcdef>
14 <paramdef>type <parameter>arg1</parameter></paramdef> 16 <paramdef>char <parameter>ch</parameter></paramdef>
17 <paramdef>FILE *<parameter>fp</parameter></paramdef>
18 </funcprototype>
19
20 <funcprototype>
21 <funcdef><function>putchar</function></funcdef>
22 <paramdef>char <parameter>ch</parameter></paramdef>
23 </funcprototype>
24
25 <funcprototype>
26 <funcdef><function>putw</function></funcdef>
27 <paramdef>int <parameter>n</parameter></paramdef>
28 <paramdef>FILE *<parameter>fp</parameter></paramdef>
15 </funcprototype> 29 </funcprototype>
16 </funcsynopsis> 30 </funcsynopsis>
17 31
18 </refsynopsisdiv> 32 </refsynopsisdiv>
19 33
20 <refsect1><title>Description</title> 34 <refsect1><title>Description</title>
21 <para> 35 <para>
22 Placeholder 36 Putc add the character "ch" to the file "fp" at the current
37 writing position and advances the position pointer.
38 </para>
39 <para>
40 Putchar is implemented as a macro (defined in the header file)
41 and is equivalent to "putc(ch,stdout)".
42 </para>
43 <para>
44 Putw adds the (two byte) machine word "n" to the file "fp" in
45 the manner of putc.
46 </para>
47 <para>
48 Output via putc is normally buffered except;
49 (a) when the buffering is disabled by "setbuf()", and
50 (b) the standard error output is always unbuffered.
23 </para> 51 </para>
24 </refsect1> 52 </refsect1>
25 53
26 <refsect1><title>Diagnostics</title> 54 <refsect1><title>Diagnostics</title>
27 <para> 55 <para>
31 </refsect1> 59 </refsect1>
32 60
33 <refsect1><title>See Also</title> 61 <refsect1><title>See Also</title>
34 <para> 62 <para>
35 <link linkend="fopen">fopen()</link>, 63 <link linkend="fopen">fopen()</link>,
36 <link linkend="fflush">fclose(), fflush()</link>, 64 <link linkend="fclose">fclose(), fflush()</link>,
37 <link linkend="getc">getc()</link>, 65 <link linkend="getc">getc()</link>,
38 <link linkend="puts">puts()</link>, 66 <link linkend="puts">puts()</link>,
39 <link linkend="printf">printf()</link>, 67 <link linkend="printf">printf()</link>,
40 <link linkend="fread">fread()</link> 68 <link linkend="fread">fread()</link>
41 </para> 69 </para>