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.

Retornar valor

Se tiver êxito, fsetpos retornará 0. Em caso de falha, a função retorna um valor diferente de zero e define errno uma das seguintes constantes de manifesto (definidas em ERRNO. H): EBADF, o que significa que o arquivo não está acessível ou o objeto que aponta para não é uma estrutura de arquivo válida, ou , o que stream significa um valor inválido para stream ou EINVALpos foi passado. Se um parâmetro inválido for passado, essas funções invocarão o manipulador de parâmetros 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 o valor de pos, que é obtido em uma chamada anterior para fgetposstream contra stream. A função limpa o indicador de fim de arquivo e desfaz quaisquer efeitos de ungetc no stream. Após uma chamada para fsetpos, a próxima operação pode stream ser de entrada ou saída.

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

Requisitos

Função	Cabeçalho necessário
fsetpos	<stdio.h>

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

Exemplo

Confira o exemplo de fgetpos.

Confira também

E/S de fluxo
fgetpos