fsetpos

Define o indicador de posição do fluxo.

Sintaxe

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

Parâmetros

stream
Ponteiro para a estrutura FILE.

pos
Armazenamento do indicador de posição.

Valor retornado

Se tiver êxito, fsetpos retornará 0. Em caso de falha, a função retorna um valor diferente de zero e é definida errno como uma das seguintes constantes de manifesto (definidas em ERRNO. H): , EBADFo que significa que o arquivo não está acessível ou o objeto que stream aponta não é uma estrutura de arquivo válida; ou EINVAL, o que significa um valor inválido para stream ou pos foi passado. Se um parâmetro inválido for passado, essas funções invocarão o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.

Para obter mais informações sobre códigos de retorno, confira errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

A fsetpos função define o indicador de posição do arquivo para stream para o valor de pos, que é obtido em uma chamada anterior para fgetpos contra stream. A função limpa o indicador de fim de arquivo e desfaz quaisquer efeitos de ungetc em stream. Após uma chamada para fsetpos, a próxima operação em stream pode ser de entrada ou saída.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Confira o exemplo de fgetpos.

Confira também

E/S de fluxo
fgetpos