fsetpos(3C) fsetpos(3C)
NAME
fsetpos, fgetpos, fsetpos64, fgetpos64 - Dateizeiger im Datenstrom neu
positionieren
SYNTAX
#include <stdio.h>
int fsetpos(FILE *stream, const fpost *pos);
int fgetpos(FILE *stream, fpost *pos);
int fsetpos64(FILE *stream, const fpos64t *pos);
int fgetpos64(FILE *stream, fpos64t *pos);
BESCHREIBUNG
fsetpos() setzt die Position der nächsten Ein- oder Ausgabeoperation
mit stream auf den Wert des Objekts, auf das pos zeigt. Das Objekt,
auf das pos zeigt, muß ein Wert sein, der aus einem vorhergehenden
Aufruf von fgetpos() mit demselben Stream resultiert.
fsetpos() löscht die Dateiendeanzeige für den Stream und macht alle
Wirkungen der Funktion ungetc() auf den Stream rückgängig. Nach
fsetpos() kann mit einer änderbaren Datei Ein- oder Ausgabeoperationen
durchgeführt werden.
fgetpos() speichert den aktuellen Wert der Dateiposition von stream in
dem Objekt, auf das pos zeigt. Der gespeicherte Wert enthält Informa-
tionen, mit denen fsetpos() den Stream auf die Position einstellen
kann, die zur Zeit des Aufrufs von fgetpos() aktuell war.
Es besteht kein funktionaler Unterschied zwischen fsetpos()/fgetpos()
und fsetpos64()/fgetpos64(), außer bei der Interpretation von
fpost/fpos64t [siehe lfs(5)].
Bei erfolgreicher Ausführung liefern fsetpos() und fgetpos() Null
zurück. Ansonsten werden Werte ungleich Null zurückgegeben.
SIEHE AUCH
lseek(2), fseek(3S), ungetc(3S), lfs(5).
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98