fgetpos
Obtém o indicador de posição do arquivo do fluxo.
int fgetpos(
FILE *stream,
fpos_t *pos
);
Parâmetros
stream
Fluxo de destino.pos
Indicador de posição armazenamento.
Valor de retorno
Se for bem-sucedido, fgetpos Retorna 0. Em caso de falha, ele retorna um valor diferente de zero e define errno uma das seguintes constantes manifesto (definidas em STDIO.H): EBADF, que significa que o fluxo especificado não é um ponteiro de arquivo válido ou não está acessível, ou EINVAL, que significa que o stream valor ou o valor de pos é inválido, sistema autônomo if ou é um ponteiro nulo. If stream ou pos é um NULL ponteiro, a função chama o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.
Comentários
The fgetpos função obtém o valor corrente das stream indicador de posição do arquivo e armazenamentos do argumento-la no objeto apontado pelo pos. The fsetpos função poderão usar posteriormente as informações armazenadas no pos Para reiniciar o stream ponteiro do argumento para sua posição no momento fgetpos foi chamado. The pos valor é armazenado em um formato interno e para uso apenas por fgetpos e fsetpos.
Requisitos
Função |
Cabeçalho necessário |
---|---|
fgetpos |
<stdio.h> |
Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Exemplo
// 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 );
}
Entrada: crt_fgetpos.txt
fgetpos gets a stream's file-position indicator.
Saída crt_fgetpos.txt
after fgetpos: gets a stream
after fsetpos: gets a stream
Equivalente do NET Framework
sistema::IO::FileStream::Position