fsetpos
Legt den Indikator für die Position im Stream fest
Syntax
int fsetpos(
FILE *stream,
const fpos_t *pos
);
Parameter
stream
Zeiger zur FILE -Struktur.
pos
Speicher des Positionsindikators
Rückgabewert
fsetpos gibt bei Erfolg 0 zurück. Bei Einem Fehler gibt die Funktion einen Wert ungleich Null zurück und legt errno sie auf eine der folgenden Manifestkonstanten fest (definiert in ERRNO. H): EBADF, das bedeutet, dass auf die Datei nicht zugegriffen werden kann oder das Objekt, auf das stream verweist, keine gültige Dateistruktur ist; oder EINVAL, was bedeutet, dass ein ungültiger Wert für stream oder pos übergeben wurde. Wenn ein ungültiger Parameter übergeben wird, rufen diese Funktionen den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung beschrieben.
Weitere Informationen zu Rückgabecodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno
Hinweise
Die fsetpos Funktion legt den Dateipositionsindikator auf stream den Wert von pos, der in einem vorherigen Aufruf von fgetpos stream. Die Funktion löscht den End-of-File-Indikator und hebt alle Auswirkungen von ungetc auf stream. Nach einem Aufruf fsetposkann der nächste Vorgang stream entweder ein- oder ausgabe sein.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Anforderungen
| Funktion | Erforderlicher Header |
|---|---|
fsetpos |
<stdio.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
Ein Beispiel hierfür finden Sie unter fgetpos.