Eine Einführung in die Programmiersprache C und die Grundlagen ...

Eine Einführung in die Informatik und die Programmiersprache C
19.5.5 Direkte (Binäre) Ein- und Ausgabe
Mit diesen Funktionen werden unformatierte Speicherblöcke gelesen und geschrieben. Das heisst
dass die Daten einfach als zusammenhängende Blöcke von Bytes behandelt werden, es findet keine
Interpretation oder Umwandlung statt.
size_t fread(void *ptr, size_t size, size_t nobj, FILE *stream)
fread liest aus stream in das Array ptr höchstens nobj Objekte der Grösse
size ein (Es werden also nobj * size Bytes gelesen). fread liefert die Anzahl
der eingelesenen Objekte; das kann weniger als die geforderte Zahl sein.
Der Zustand des Datenstroms muss mit feof und ferror untersucht werden.
size_t fwrite(const void *ptr, size_t size, size_t nobj, FILE *stream)
fwrite schreibt nobj Objekte der Grösse size aus dem Array ptr in stream
(Es werden also nobj * size Bytes geschrieben). Die Funktion liefert die
Anzahl der ausgegebenen Objekte; bei Fehler ist das weniger als nobj.
19.5.6 Positionieren in Dateien
Mit diesen Funktionen kann die aktuelle Schreib oder Leseposition in der Datei abgefragt oder gesetzt
werden. Dies macht vor allem bei direkter Ein- und Ausgabe Sinn.
int fseek(FILE *stream, long offset, int origin)
fseek setzt die Dateiposition für stream; eine nachfolgende Lese- oder
Schreiboperation wird auf Daten von der neuen Position an zugreifen. Für
eine binäre Datei wird die Position auf offset Zeichen relativ zu origin eingestellt;
dabei können für origin die Werte SEEK_SET (Dateianfang)
SEEK_CUR (aktuelle Position) oder SEEK_END (Dateiende) angegeben
werden. Für einen Textstrom muss offset Null sein oder ein Wert, der von
ftell stammt (dafür muss dann origin den Wert SEEK_SET erhalten). fseek
liefert einen von Null verschiedenen Wert bei Fehler.
long ftell(FILE *stream)
ftell liefert die aktuelle Dateiposition für stream oder -1L bei Fehler. ftell
ist somit das Gegenstück zu fseek.
void rewind(FILE *stream)
rewind(fp) ist äquivalent zu fseek(fp, OL, SEEK_SET); clearerr(fp); Es
setzt den Dateizeiger auf den Anfang der Datei zurück. Der nächste
Schreib- oder Lesezugriff erfolgt am Dateianfang.
int fgetpos(FILE *stream, fpos_t *ptr) fgetpos speichert die aktuelle Position für stream bei *ptr. Der Wert kann
später mit fsetpos verwendet werden. Der Datentyp fpos_t eignet sich zum
Speichern von solchen Werten. Bei Fehler liefert fgetpos einen von Null
verschiedenen Wert.
int fsetpos(FILE *stream, const fpos_t *ptr)
fsetpos positioniert stream auf die Position, die von fgetpos in *ptr abgelegt
wurde. Bei Fehler liefert fsetpos einen von Null verschiedenen Wert.
19.5.7 Fehlerbehandlung
Viele der Bibliotheksfunktionen notieren Zustandsangaben, z. B. wenn ein Dateiende oder ein Fehler
gefunden wird. Diese Angaben können explizit gesetzt und getestet werden. Ausserdem kann
der Integer-Ausdruck errno (der in deklariert ist) eine Fehlernummer enthalten, die
mehr Information über den zuletzt aufgetretenen Fehler liefert.
void clearerr(FILE *stream)
int feof(FILE *stream)
int ferror(FILE *stream)
void perror(const char *s)
clearerr löscht die Dateiende- und Fehlernotizen für stream.
feof liefert einen von Null verschiedenen Wert, wenn für stream ein Dateiende
notiert ist. (Also das Dateiende erreicht wurde).
ferror liefert einen von Null verschiedenen Wert, wenn für stream ein Fehler
notiert ist.
perror(s) gibt s und eine von der Implementierung definierte Fehlermeldung
aus, die sich auf die Fehlernummer in errno bezieht. Die Ausgabe erfolgt
im Stil von fprintf(stderr, "%s: %s\n", s, "Fehlermeldung")
Gedruckt am 10.09.2009 14:23:00 Letzte Änderung am: 10. September 2009 Version 2.4.1, I. Oesch 80/147