Partilhar via


fsetpos

Define o indicador de posição do fluxo.

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

Parâmetros

  • stream
    Ponteiro para FILE estrutura.

  • pos
    Armazenamento de indicador de posição.

Valor de retorno

Se for bem-sucedido, fsetpos retorna 0.Em caso de falha, a função retorna um valor diferente de zero e define errno para um dos seguintes manifesto constantes (definidos no ERRNO.H): EBADF, que significa que o arquivo não está acessível ou o objeto que stream aponta para não é uma estrutura de arquivo válido; ou EINVAL, que significa que um valor inválido para stream ou pos foi passado.Se um parâmetro inválido for passado, essas funções chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.

Consulte _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre estes e outros, códigos de retorno.

Comentários

O fsetpos função define o indicador de posição do arquivo para stream como o valor de pos*,* que é obtido em uma chamada anterior para fgetpos contra stream*.* A função limpa o indicador de final de arquivo e Desfaz quaisquer efeitos de ungetc na stream*.* Depois de chamar o fsetpos, a próxima operação no stream pode ser de entrada ou saída.

Requisitos

Função

Cabeçalho necessário

fsetpos

<stdio.h>

Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.

Exemplo

Consulte o exemplo para fgetpos.

Equivalência do .NET Framework

System::IO::FileStream::position

Consulte também

Referência

Fluxo de i/O

fgetpos