.\" 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
.\" Translated to German Mon Aug 01 18:00:00 1996 by Patrick Rother <krd@gulu.net>
.\"
.TH STDIO 3  "01. August 1996" "BSD MANPAGE" "Linux Programmierhandbuch"
.SH BEZEICHNUNG
stdio \- Standard Ein-/Ausgabe Bibliotheksfunktionen
.SH BERSICHT
.B #include <stdio.h>
.sp
.B FILE *stdin;
.br
.B FILE *stdout;
.br
.B FILE *stderr;
.SH BESCHREIBUNG
Die Standard-E/A-Bibliothek stellt eine einfaches und effiziente gepufferte
Stream-E/A-Schnittstelle zur Verfgung. Ein- und Ausgabe wird in logische
Datenstreams geleitet und physikalische E/A-Charakteristiken werden
verborgen. Die Funktionen und Makros sind unten aufgelistet; weitere
Informationen sind verfgbar durch die individuellen Handbuchseiten.
.PP
Ein Stream wird mit einer externen Datei (die ein
phyikalisches Gert sein darf) verbunden, indem eine Datei
.I geffnet
wird, was das Erzeugen einer neuen Datei nach sich ziehen kann.
Erzeugen einer bestehenden Datei bewirkt, da die frheren Inhalte gelscht
werden.  Wenn die Datei Positionierungsanweisungen unterstzt (wie eine
Festplattendatei, im Gegensatz zu einem Terminal), dann wird ein
.I Dateipositionszeiger
(file position indicator) mit dem Stream in Verbindung gebracht und auf
den Anfang der Datei positioniert (Byte Null), solange die Datei nicht im 
anhngen-Modus geffnet wurde. Wenn anhngen-Modus gewhlt wird wird 
der Dateipositionszeiger auf das Ende der Datei gesetzt.  Der Positionszeiger
wird durch aufeinanderfolgende Lese-, Schreib- und Positionierungszugriffe
verwaltet. Jede Eingabe erscheint, als wenn die Zeichen durch
aufeinanderfolgende Aufrufe der Funktion
.BR fgetc (3)
gelesen worden wren; jede Ausgabe findet statt als wenn alle Zeichen durch
aufeinanderfolgende Aufrufe der Funktion
.BR fputc (3)
gelesen worden wren.
.PP
Eine Datei wird von einem Stream gelst durch
.I schlieen
der Datei. Ausgabestreams werden geflusht (noch nicht geschriebene 
Pufferinhalte werden bertragen) bevor der Stream von der Datei getrennt
wird.  Der Wert eines Zeigers auf ein Objekt
.B FILE
ist ungltig, nachdem die Datei geschlossen wurde.
.PP
Eine Datei kann nachfolgend wieder geffnet, durch das selbe
oder ein anderes Programm, und ihre Inhalte zurckgelesen oder verndert
(wenn sie auf den Anfang repositioniert werden kann) werden.  Wenn die
Hauptfunktion zu ihren ursprnglichen Aufrufer zurckkehrt, oder die Funktion
.BR exit (3)
aufgerufen wird, werden alle offenen Dateien vor Programmende geschlossen
(nachdem alle Ausgabestreams geflusht wurden).  Andere Methoden zur Beendigung
von Programmen wie
.BR abort (3)
kmmern sich nicht um das korrekte Schlieen von Dateien.
.PP
Bei Programmstart sind drei Textstreams vordefiniert und brauchen nicht
explizit geffnet zu werden \(em
.I Standardeingabe
(zum Lesen konventioneller Eingabe), \(em
.I Standardausgabe
(zum Schreiben konventioneller Ausgabe), und
.I Standardfehlerausgabe
(zum Schreiben von Diagnosedaten).  Diese Streams werden abgekrzt durch
.IR stdin , stdout
und
.IR stderr .
Der Stream der Standardfehlerausgabe ist nicht voll gepuffert wenn er
geffnet ist; die Streams der Standardein- und ausgabe sind voll gepuffert
genau dann, wenn die Streams nicht auf ein interaktivers Gert verweisen.
.PP
Ausgabestreams, die auf Terminalgerte verweisen, sind immer zeilengepuffert
per Vorgabe; noch ausstehende Ausgabe zu solchen Streams wird automatisch
geschrieben wannimmer ein Eingabestream, der sich auf ein Terminalgert 
bezieht, gelesen wird.  In Fllen, wo eine groe Rechenarbeit durchgefhrt
wird nach Ausgabe eines Teils einer Zeile auf ein Ausgabeterminal, ist es
ntig,
.BR fflush (3)
aufzurufen um die Standardausgabe zu flushen bevor die Rechnung durchgefhrt
wird so dass die Ausgabe auch erscheint.
.PP
Die Bibliothek
.B stdio
ist Teil der Bibliothek
.B libc
und Routinen werden automatisch geladen wenn sie von den Kompilern
.BR cc (1)
und
.BR pc (1)
bentigt.
Die Abschnitte
.B BERSICHT
der folgenden Handbuchseiten zeigen, welche Include-Dateien zu benutzen sind,
wie die Kompilerdeklaration fr die Funkion aussieht und welche externen
Variablen interessant sind.
.PP
Die folgenden sind als Makros definiert; diese Namen drfen nicht
wiederbenutzt werden ohne sie vorher mit
.BR #undef
zu entfernen:
.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 .
Funktionsversionen der Makrofunktionen
.BR feof ,
.BR ferror ,
.BR clearerr ,
.BR fileno ,
.BR getc ,
.BR getchar ,
.BR putc ,
und
.B putchar
existieren und werden benutzt wenn die Makrodefinitionen explizit entfernt
werden.
.SH "SIEHE AUCH"
.BR open (2),
.BR close (2),
.BR read (2),
.BR write (2).
.SH BUGS
Die gepufferten Standardfunktionen arbeiten nicht gut mit bestimmten anderen
Bibliotheks- und Systemfunktionen zusammen, insbesondere
.B vfork
und
.BR abort .
Dies muss nicht der Fall sein unter Linux.
.SH STANDARDS
Die Bibliotheksfunktion
.B stdio
ist konform zu ANSI C3.159-1989 (``ANSI C'').
.SH "LISTE VON FUNKTIONEN"
.TP
.B Function
.B Beschreibung
.TP
clearerr
Teste Stream-Status und setze ihn zurck.
.TP
fclose
Schliee einen Stream.
.TP
fdopen
Funktionen zum ffnen eines Streams.
.TP
feof
Teste Streamstatus und setze ihn zurck.
.TP
ferror
Teste Streamstatus und setze ihn zurck.
.TP
fflush
Schreibe ausstehende Daten des Streams.
.TP
fgetc
Hole das nchste Zeichen oder Wort vom Eingabestream.
.TP
fgetline
Hole eine Zeile vom Stream.
.TP
fgetpos
Re-positioniere den Positionszeiger des Streams.
.TP
fgets
Hole eine Zeile vom Stream.
.TP
fileno
Teste den Stream-Status und setze ihn zurueck.
.TP
fopen
Funktionen zum ffnen eines Streams.
.TP
fprintf
Gib Text formatiert auf dem Stream aus.
.TP
fpurge
Flushe einen Stream.
.TP
fputc
Gib ein Zeichen oder Wort auf dem Stream aus.
.TP
fputs
Gib eine Zeile auf dem Stream aus.
.TP
fread
Binres Lesen von einem Stream.
.TP
freopen
Funktionen zum ffnen eines Streams.
.TP
fropen
ffne einen Stream.
.TP
fscanf
Formatiertes Einlesen.
.TP
fseek
Repositioniere einen Stream.
.TP
fsetpos
Repositioniere einen Stream.
.TP
ftell
Repositioniere einen Stream.
.TP
fwrite
Binres Schreiben auf einem Stream.
.TP
getc
Hole das nchsten Zeichen oder Wort vom Eingabestream.
.TP
getchar
Hole das nchsten Zeichen oder Wort vom Eingabestream.
.TP
gets
Hole eine Zeile vom Eingabestream.
.TP
getw
Hole das nchsten Zeichen oder Wort vom Eingabestream.
.TP
mktemp
Erzeuge einen eindeutigen temporren Dateinamen.
.TP
perror
Systemfehlermeldungen.
.TP
printf
Formatierte Ausgabeumwandlung.
.TP
putc
Gib ein Zeichen oder Wort auf dem Stream aus.
.TP
putchar
Gib ein Zeichen oder Wort auf dem Stream aus.
.TP
puts
Gib eine Zeile auf dem Stream aus.
.TP
putw
Gib ein Zeichen oder Wort auf dem Stream aus.
.TP
remove
Lsche einen Verzeichniseintrag.
.TP
rewind
Repositioniere einen Stream.
.TP
scanf
Formatiertes Einlesen.
.TP
setbuf
Stream-Puffer Operationen.
.TP
setbuffer
Stream-Puffer Operationen.
.TP
setlinebuf
Stream-Puffer Operationen.
.TP
setvbuf
Stream-Puffer Operationen.
.TP
sprintf
Formatierte Ausgabeumwandlung.
.TP
sscanf
Formatiertes Einlesen.
.TP
strerror
Systemfehlermeldungen.
.TP
sys_errlist
Systemfehlermeldungen.
.TP
sys_nerr
Systemfehlermeldungen.
.TP
tempnam
Routinen fr temporre Dateien.
.TP
tmpfile
Routinen fr temporre Dateien.
.TP
tmpnam
Routinen fr temporre Dateien.
.TP
ungetc
Lege ein Zeichen zurck in den Eingabestream.
.TP
vfprintf
Formatierte Ausgabeumwandlung.
.TP
vfscanf
Formatiertes Einlesen.
.TP
vprintf
Formatierte Ausgabeumwandlung.
.TP
vscanf
Formatiertes Einlesen.
.TP
vsprintf
Formatierte Ausgabeumwandlung.
.TP
vsscanf
Formatiertes Einlesen.