Freigeben über


fsetpos

Legt den Stellungsanzeiger fest.

int fsetpos( 
   FILE *stream,
   const fpos_t *pos 
);

Parameter

  • stream
    Zeiger zur FILE-Struktur.

  • pos
    Position-Indikatorspeicher.

Rückgabewert

Wenn erfolgreich, fsetpos gibt 0 zurück. Auf Fehler gibt die Funktion einen Wert ungleich 0 (null) zurück und legt errno auf eine der folgenden Manifestkonstanten fest (in ERRNO.H): EBADF, die die Datei bedeutet, ist jedoch nicht zugänglich oder das Objekt, in denen stream auf keine gültige Dateistruktur ist; oder EINVAL, die einen ungültigen Wert für stream oder pos bedeutet, wurde übergeben. Wenn ein ungültiger Parameter übergeben wird, rufen diese Funktionen den ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben.

Weitere Informationen zu diesen und anderen Rückgabecodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

Hinweise

Die Funktion fsetpos wird der Stellungsanzeiger für stream auf den Wert posfest, der in einem früheren Aufruf von fgetpos für stream aufgerufen wird . Die Funktion löscht den Dateiende-Indikator und macht alle Effekte von ungetc auf streamrückgängig. Nachdem die fsetpos aufgerufen hat, wird der folgende Operation möglicherweise auf stream entweder oder Ausgabe eingegeben.

Anforderungen

Funktion

Erforderlicher Header

fsetpos

<stdio.h>

Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Beispiel

Im Beispiel für fgetpos.

.NET Framework-Entsprechung

System::IO::FileStream::Position

Siehe auch

Referenz

Stream-E/A

fgetpos