fgetpos
Ottiene la posizione indicatore di un flusso.
int fgetpos(
FILE *stream,
fpos_t *pos
);
Parametri
stream
Flusso di destinazione.pos
Archiviazione dell'indicatore di posizione.
Valore restituito
In caso di successo, fgetpos restituisce 0. In caso di errore, restituisce un valore diverso da zero e imposta errno a una delle costanti del manifest (definite in STDIO.H): EBADF, ovvero il flusso specificato non è un puntatore di file valido o non è accessibile, o EINVAL, il cui valore di stream o il valore di pos non è valido, ad esempio se uno è un puntatore null. Se stream o pos è un puntatore a NULL, la funzione richiama il gestore di parametro non valido, come descritto in Convalida dei parametri.
Note
La funzione fgetpos ottiene il valore corrente dell'indicatore della posizione dell'argomento di stream e lo memorizza nell'oggetto puntato da pos. La funzione fsetpos può usare successivamente informazioni archiviate in pos per reimpostare il puntatore dell'argomento di stream nella posizione fgetpos quando è stato chiamato. Il valore di pos viene archiviato in un formato interno e deve essere utilizzata solo da fgetpos e da fsetpos.
Requisiti
Funzione |
Intestazione obbligatoria |
---|---|
fgetpos |
<stdio.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'Introduzione.
Esempio
// 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 );
}
Input: crt_fgetpos.txt
fgetpos gets a stream's file-position indicator.
Output Crt_fgetpos.txt
after fgetpos: gets a stream
after fsetpos: gets a stream
Equivalente .NET Framework
System::IO::FileStream::Position