diff options
Diffstat (limited to 'man3/stdio.3')
| -rw-r--r-- | man3/stdio.3 | 355 |
1 files changed, 0 insertions, 355 deletions
diff --git a/man3/stdio.3 b/man3/stdio.3 deleted file mode 100644 index a4192d5062..0000000000 --- a/man3/stdio.3 +++ /dev/null @@ -1,355 +0,0 @@ -.\" Copyright (c) 1990, 1991 Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)stdio.3 6.5 (Berkeley) 5/6/91 -.\" -.\" Converted for Linux, Mon Nov 29 16:07:22 1993, faith@cs.unc.edu -.\" -.TH STDIO 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -stdio \- standard input/output library functions -.SH SYNOPSIS -.B #include <stdio.h> -.sp -.B FILE *stdin; -.br -.B FILE *stdout; -.br -.B FILE *stderr; -.SH DESCRIPTION -The standard I/O library provides a simple and efficient buffered stream -I/O interface. Input and ouput is mapped into logical data streams and the -physical I/O characteristics are concealed. The functions and macros are -listed below; more information is available from the individual man pages. -.PP -A stream is associated with an external file (which may be a physical -device) by -.I opening -a file, which may involve creating a new file. Creating an existing file -causes its former contents to be discarded. If a file can support -positioning requests (such as a disk file, as opposed to a terminal) then a -.I file position indicator -associated with the stream is positioned at the start of the file (byte -zero), unless the file is opened with appened mode. If append mode is used, -the position indicator will be placed the end-of-file. The position -indicator is maintained by subsequent reads, writes and positioning -requests. All input occurs as if the characters were read by successive -calls to the -.BR fgetc (3) -function; all ouput takes place as if all characters were read by -successive calls to the -.BR fputc (3) -function. -.PP -A file is disassociated from a stream by -.I closing -the file. Ouput streams are flushed (any unwritten buffer contents are -transfered to the host environment) before the stream is disassociated from -the file. The value of a pointer to a -.B FILE -object is indeterminate after a file is closed (garbage). -.PP -A file may be subsequently reopened, by the same or another program -execution, and its contents reclaimed or modified (if it can be -repositioned at the start). If the main function returns to its original -caller, or the -.BR exit (3) -function is called, all open files are closed (hence all output streams are -flushed) before program termination. Other methods of program termination, -such as -.BR abort (3) -do not bother about closing files properly. -.PP -At program startup, three text streams are predefined and need not be -opened explicitly \(em -.I standard input -(for reading converntional input), \(em -.I standard output -(for writing converntional input), and -.I standard error -(for writing diagnostic output). These streams are abbreviated -.IR stdin , stdout -and -.IR stderr . -When opened, the standard error stream is not fully buffered; the standard -input and output streams are fully buffered if and only if the streams do -not to refer to an interactive device. -.PP -Output streams that refer to terminal devices are always line buffered by -default; pending output to such streams is written automatically whenever -an input stream that refers to a terminal device is read. In cases where a -large amount of computation is done after printing part of a line on an -output terminal, it is necessary to -.BR fflush (3) -the standard output before going off and computing so that the output will -appear. -.PP -The -.B stdio -library is a part of the library -.B libc -and routines are automatically loaded as needed by the compilers -.BR cc (1) -and -.BR pc (1). -The -.B SYNOPSIS -sections of the following manual pages indicate which include files are to -be used, what the compiler declaration for the function looks like and -which external variables are of interest. -.PP -The following are defined as macros; these names may not be re-used without -first removing their current definitions with -.BR #undef : -.BR BUFSIZ , -.BR EOF , -.BR FILENAME_MAX , -.BR FOPEN_MAX , -.BR L_cuserid , -.BR L_ctermid , -.BR L_tmpnam, -.BR NULL , -.BR SEEK_END , -.BR SEEK_SET , -.BR SEE_CUR , -.BR TMP_MAX , -.BR clearerr , -.BR feof , -.BR ferror , -.BR fileno , -.BR fropen , -.BR fwopen , -.BR getc , -.BR getchar , -.BR putc , -.BR putchar , -.BR stderr , -.BR stdin , -.BR stdout . -Function versions of the macro functions -.BR feof , -.BR ferror , -.BR clearerr , -.BR fileno , -.BR getc , -.BR getchar , -.BR putc , -and -.B putchar -exist and will be used if the macros definitions are explicitly removed. -.SH "SEE ALSO" -.BR open "(2), " close "(2), " read "(2), " write (2) -.SH BUGS -The standard buffered functions do not interact well with certain other -library and system functions, especially -.B vfork -and -.BR abort . -This may not be the case under Linux. -.SH STANDARDS -The -.B stdio -library conforms to ANSI C3.159-1989 (``ANSI C''). -.SH "LIST OF FUNCTIONS" -.TP -.B Function -.B Description -.TP -clearerr -check and reset stream status -.TP -fclose -close a stream -.TP -fdopen -stream open functions -.TP -feof -check and reset stream status -.TP -ferror -check and reset stream status -.TP -fflush -flush a stream -.TP -fgetc -get next character or word from input stream -.TP -fgetline -get a line from a stream -.TP -fgetpos -reposition a stream -.TP -fgets -get a line from a stream -.TP -fileno -check and reset stream status -.TP -fopen -stream open functions -.TP -fprintf -formatted output conversion -.TP -fpurge -flush a stream -.TP -fputc -output a character or word to a stream -.TP -fputs -output a line to a stream -.TP -fread -binary stream input/output -.TP -freopen -stream open functions -.TP -fropen -open a stream -.TP -fscanf -input format conversion -.TP -fseek -reposition a stream -.TP -fsetpos -reposition a stream -.TP -ftell -reposition a stream -.TP -fwrite -binary stream input/output -.TP -getc -get next character or word from input stream -.TP -getchar -get next character or word from input stream -.TP -gets -get a line from a stream -.TP -getw -get next character or word from input stream -.TP -mktemp -make temporary file name (unique) -.TP -perror -system error messages -.TP -printf -formatted output conversion -.TP -putc -output a character or word to a stream -.TP -putchar -output a character or word to a stream -.TP -puts -output a line to a stream -.TP -putw -output a character or word to a stream -.TP -remove -remove directory entry -.TP -rewind -reposition a stream -.TP -scanf -input format conversion -.TP -setbuf -stream buffering operations -.TP -setbuffer -stream buffering operations -.TP -setlinebuf -stream buffering operations -.TP -setvbuf -stream buffering operations -.TP -sprintf -formatted output conversion -.TP -sscanf -input format conversion -.TP -strerror -system error messages -.TP -sys_errlist -system error messages -.TP -sys_nerr -system error messages -.TP -tempnam -temporary file routines -.TP -tmpfile -temporary file routines -.TP -tmpnam -temporary file routines -.TP -ungetc -un-get character from input stream -.TP -vfprintf -formatted output conversion -.TP -vfscanf -input format conversion -.TP -vprintf -formatted output conversion -.TP -vscanf -input format conversion -.TP -vsprintf -formatted output conversion -.TP -vsscanf -input format conversion |