fsetpos

Define o indicador de posição do fluxo.

Sintaxe

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

Parâmetros

fluxo
Ponteiro para a estrutura FILE.

pos
Armazenamento do indicador de posição.

Valor Retornado

Se for bem-sucedido, fsetpos retornará 0. Em caso de falha, a função retorna um valor diferente de zero e define errno como uma das constantes de manifesto a seguir (definidas em errno. H): EBADF, que significa que o arquivo não está acessível ou o objeto ao qual o fluxo aponta não é uma estrutura de arquivo válida; ou EINVAL, o que significa que 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.

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

Comentários

A função fsetpos define o indicador de posição de arquivo para fluxo para o valor de pos, que é obtido em uma chamada anterior para fgetpos em relação ao fluxo. A função limpa o indicador de fim de arquivo e desfaz os efeitos de ungetc no fluxo. Depois de chamar fsetpos, a próxima operação no fluxo pode ser entrada ou saída.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar isso, consulte estado global no CRT.

Requisitos

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

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

Exemplo

Veja o exemplo de fgetpos.

Consulte também

E/S de fluxo
fgetpos