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