Mercurial > hg > Members > kono > nitros9-code

comparison docs/ccguide/setbuf.refentry @ 527:10d95ea9f140

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Finished these entries
author roug
date Fri, 11 Oct 2002 19:11:01 +0000
parents 60b821f18853
children 032365886652
comparison
equal deleted inserted replaced
526:85a3168ccab5 527:10d95ea9f140
1 <refentry id="setbuf"> 1 <refentry id="setbuf">
2 <refnamediv> 2 <refnamediv>
3 <refname>setbuf</refname> 3 <refname>Setbuf</refname>
4 <refpurpose>Placeholder</refpurpose> 4 <refpurpose>fix file buffer</refpurpose>
5 </refnamediv> 5 </refnamediv>
6 6
7 <refsynopsisdiv> 7 <refsynopsisdiv>
8 <funcsynopsis> 8 <funcsynopsis>
9 <funcsynopsisinfo> 9 <funcsynopsisinfo>
10 #include &lt;stdio.h&gt; 10 #include &lt;stdio.h&gt;
11 </funcsynopsisinfo> 11 </funcsynopsisinfo>
12 <funcprototype> 12 <funcprototype>
13 <funcdef><function>setbuf</function></funcdef> 13 <funcdef><function>setbuf</function></funcdef>
14 <paramdef>type <parameter>arg1</parameter></paramdef> 14 <paramdef>FILE *<parameter>fp</parameter></paramdef>
15 <paramdef>char *<parameter>buffer</parameter></paramdef>
15 </funcprototype> 16 </funcprototype>
16 </funcsynopsis> 17 </funcsynopsis>
17 18
18 </refsynopsisdiv> 19 </refsynopsisdiv>
19 20
20 <refsect1><title>Description</title> 21 <refsect1><title>Description</title>
21 <para> 22 <para>
22 Placeholder 23 When the first character is written to or read from a file
24 after it has been opened by "fopen()", a buffer is obtained
25 from the system if required and assigned to it. Setbuf may be
26 used to forestall this by assigning a user buffer to the file.
27 </para>
28 <para>
29 Setbuf must be used after the file has been opened and before
30 any I/O has taken place.
31 </para>
32 <para>
33 The buffer must be of sufficient size and a value for a
34 manifest constant, BUFSIZ, is defined in the header file for
35 use in declarations.
36 </para>
37 <para>
38 If the "buffer" argument is NULL (0), the file becomes unbuffered
39 and characters are read or written singly.
40 </para>
41 <para>
42 NOTE that the standard error output is unbuffered and the
43 standard output is buffered.
44 </para>
45 </refsect1>
46 <refsect1><title>See Also</title>
47 <para>
48 fopen(),getc(),putc()
23 </para> 49 </para>
24 </refsect1> 50 </refsect1>
25 </refentry> 51 </refentry>
52 </refentry>