fgetpos
Ruft den Dateipositionsindikator eines Streams ab
Syntax
int fgetpos(
FILE *stream,
fpos_t *pos
);
Parameter
stream
Der Zielstream
pos
Speicher des Positionsindikators
Rückgabewert
fgetpos
gibt bei Erfolg 0 zurück. Wenn ein Fehler auftritt, wird ein Wert ungleich Null zurückgegeben und auf eine der folgenden Manifestkonstanten (definiert in STDIO) festgelegt errno
. H): EBADF
, das bedeutet, dass der angegebene Datenstrom kein gültiger Dateizeiger ist oder nicht darauf zugegriffen werden kann, oder EINVAL
, was bedeutet, dass der stream
Wert oder der Wert pos
ungültig ist, z. B. wenn es sich um einen Nullzeiger handelt. Wenn stream
oder pos
ein NULL
Zeiger ist, ruft die Funktion den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung beschrieben.
Hinweise
Die Funktion fgetpos
ruft den aktuellen Wert des Dateipositionsindikators des stream
-Arguments ab und speichert es in dem Objekt, auf das pos
verweist. Die Funktion fsetpos
kann die in pos
gespeicherten Informationen später verwenden, um den Zeiger des stream
-Arguments auf die Position zurückzusetzen, die er zum Zeitpunkt des Aufrufs von fgetpos
inne hatte. Der Wert pos
wird in einem internen Format gespeichert und dient nur zur Verwendung durch fgetpos
und fsetpos
.
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 |
---|---|
fgetpos |
<stdio.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
// crt_fgetpos.c
// This program uses fgetpos and fsetpos to
// return to a location in a file.
#include <stdio.h>
int main( void )
{
FILE *stream;
fpos_t pos;
char buffer[20];
if( fopen_s( &stream, "crt_fgetpos.txt", "rb" ) ) {
perror( "Trouble opening file" );
return -1;
}
// Read some data and then save the position.
fread( buffer, sizeof( char ), 8, stream );
if( fgetpos( stream, &pos ) != 0 ) {
perror( "fgetpos error" );
return -1;
}
fread( buffer, sizeof( char ), 13, stream );
printf( "after fgetpos: %.13s\n", buffer );
// Restore to old position and read data
if( fsetpos( stream, &pos ) != 0 ) {
perror( "fsetpos error" );
return -1;
}
fread( buffer, sizeof( char ), 13, stream );
printf( "after fsetpos: %.13s\n", buffer );
fclose( stream );
}
Eingabe: crt_fgetpos.txt
fgetpos gets a stream's file-position indicator.
Ausgabe: crt_fgetpos.txt
after fgetpos: gets a stream
after fsetpos: gets a stream
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für