fsetpos

  • Artikel

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 fgetposstream. 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. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Anforderungen

Funktion Erforderlicher Header
fsetpos <stdio.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

Sehen Sie sich das Beispiel für fgetpos.

Siehe auch

Stream-E/A
fgetpos