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
| Função | Cabeçalho necessário |
|---|---|
fsetpos |
<stdio.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Exemplo
Confira o exemplo de fgetpos.