1 .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
3 .\" Permission is granted to make and distribute verbatim copies of this
4 .\" manual provided the copyright notice and this permission notice are
5 .\" preserved on all copies.
7 .\" Permission is granted to copy and distribute modified versions of this
8 .\" manual under the conditions for verbatim copying, provided that the
9 .\" entire resulting derived work is distributed under the terms of a
10 .\" permission notice identical to this one
12 .\" Since the Linux kernel and libraries are constantly changing, this
13 .\" manual page may be incorrect or out-of-date. The author(s) assume no
14 .\" responsibility for errors or omissions, or for damages resulting from
15 .\" the use of the information contained herein. The author(s) may not
16 .\" have taken the same level of care in the production of this manual,
17 .\" which is licensed free of charge, as they might when working
20 .\" Formatted or processed versions of this manual, if unaccompanied by
21 .\" the source, must acknowledge the copyright and authors of this work.
23 .\" Modified Wed Jul 28 11:12:07 1993 by Rik Faith (faith@cs.unc.edu)
24 .\" Modified Fri Sep 8 15:48:13 1995 by Andries Brouwer (aeb@cwi.nl)
25 .\" Translated to German Sun Dec 1 1996 by Patrick Rother <krd@gulu.net>
27 .TH GETS 3 "1. Dezember 1996" "GNU" "Bibliotheksfunktionen"
29 fgetc, fgets, getc, getchar, ungetc \- Eingabe von Zeichen und Strings
34 .BI "int fgetc(FILE *" stream ");"
36 .BI "char *fgets(char *" "s" ", int " "size" ", FILE *" "stream" ");"
38 .BI "int getc(FILE *" stream ");"
40 .BI "int getchar(void);"
42 .BI "char *gets(char *" "s" ");"
44 .BI "int ungetc(int " c ", FILE *" stream ");"
47 liest das nächste Zeichen von
55 bei Ende oder Datefehler.
60 außer dass es als ein Makro implementiert sein darf, der
62 mehr als einmal auswertet.
66 .BI "getc(" stdin ) \fR.
71 in der Puffer, auf den
73 zeigt, bis entweder ein abschließender Zeilenvorschub oder
75 auftritt, welche durch
78 Es wird keine Prüfung auf Pufferüberlauf durchgeführt (siehe
88 und speichert sie in dem Puffer, auf den
91 Das Lesen stoppt nach einem
93 oder Zeilenvorschub. Wenn ein Zeilenvorschub gelesen wird, wird er in dem
94 Puffer gespeichert. Ein
96 wird nach dem letzten Zeichen im Puffer gespeichert.
104 .BR "unsigned char" ,
105 wenn es für folgende Leseoperationen möglich ist. Zurückgeschobene Zeichen
106 werden in umgekehrter Reihenfolge zurückgegeben; nur ein Zurückschieben
109 Aufrufe der hier beschriebenen Funktionen können für den selben Eingabestream
110 untereinander und mit anderen Eingabefunktionen der Bibliothek
114 .BR fgetc() , " getc() " und " getchar()"
115 geben das gelesene Zeichen als ein
121 bei Dateiende oder Fehler.
123 .BR gets() " und " fgets()
126 zurück bei Erfolg, und
128 im Fehlerfall oder wenn Dateiende auftritt ohne dass Zeichen gelesen wurden.
133 zurück bei Erfolg, oder
139 Da es unmöglich ist zu sagen, wie viele Zeichen
142 lesen wird, ohne die Daten vorher zu kennen und da
144 fortfährt und Daten über das Ende des Puffers hinaus speichert, ist es sehr
145 gefährlich, diese Funktion zu benutzen. Sie wurde benutzt um in Rechner
146 einzubrechen. Benutze
150 Es ist nicht ratsam, Aufrufe von Funktionen der Bibliothek
152 mit low-level-Aufrufen von
154 für den Dateideskriptor zu mischen, der mit demselben Eingabestream
155 verbunden ist; die Ergebnisse sind undefiniert und sehr wahrscheinlich