Mercurial > hg > Members > kono > nitros9-code
view docs/ccguide/setbuf.refentry @ 527:10d95ea9f140
Finished these entries
author | roug |
---|---|
date | Fri, 11 Oct 2002 19:11:01 +0000 |
parents | 60b821f18853 |
children | 032365886652 |
line wrap: on
line source
<refentry id="setbuf"> <refnamediv> <refname>Setbuf</refname> <refpurpose>fix file buffer</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> #include <stdio.h> </funcsynopsisinfo> <funcprototype> <funcdef><function>setbuf</function></funcdef> <paramdef>FILE *<parameter>fp</parameter></paramdef> <paramdef>char *<parameter>buffer</parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1><title>Description</title> <para> When the first character is written to or read from a file after it has been opened by "fopen()", a buffer is obtained from the system if required and assigned to it. Setbuf may be used to forestall this by assigning a user buffer to the file. </para> <para> Setbuf must be used after the file has been opened and before any I/O has taken place. </para> <para> The buffer must be of sufficient size and a value for a manifest constant, BUFSIZ, is defined in the header file for use in declarations. </para> <para> If the "buffer" argument is NULL (0), the file becomes unbuffered and characters are read or written singly. </para> <para> NOTE that the standard error output is unbuffered and the standard output is buffered. </para> </refsect1> <refsect1><title>See Also</title> <para> fopen(),getc(),putc() </para> </refsect1> </refentry> </refentry>