fgetpos

Ruft Stellungsanzeiger eines Streams ab.

int fgetpos( 
   FILE *stream,
   fpos_t *pos 
);

Parameter

• stream
  Zielstream.

• pos
  Position-Indikatorspeicher.

Rückgabewert

Wenn erfolgreich, fgetpos gibt 0 zurück. Bei einem Fehler wird ein Wert ungleich 0 (null) zurück und legt errno auf eine der folgenden Manifestkonstanten fest (in STDIO.H): EBADF, der den jeweiligen Stream bedeutet, ist kein gültiger Dateizeiger oder ist nicht möglich oder EINVAL verwendet, der Folgendes bedeutet, dass der stream-Wert oder der Wert von pos ungültig wird, beispielsweise, wenn entweder ein NULL-Zeiger ist. Wenn stream oder pos ein NULL Zeiger ist, ruft die Funktion den ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben.

Hinweise

Die Funktion ruft fgetpos den aktuellen Wert des stream Stellungsanzeigers Arguments ab und speichert ihn im Objekt, das auf den durch pos gezeigt wird. Die fsetpos-Funktion kann Informationen später verwenden, die in pos gespeichert werden, um den Zeiger des stream-Arguments an seiner Position zurückzusetzen, wenn fgetpos aufgerufen wurde. Der Wert pos wird in einem internen Format gespeichert und ist nur über fgetpos und fsetpos bestimmt.

Anforderungen

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

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

.NET Framework-Entsprechung

System::IO::FileStream::Position

Siehe auch

Referenz

Stream-E/A

fsetpos