fsetpos
Define o indicador de - posição.
int fsetpos(
FILE *stream,
const fpos_t *pos
);
Parâmetros
stream
Ponteiro a estrutura de FILE .pos
Armazenamento de Posição- medidor.
Valor de retorno
Se tiver êxito, retorna 0 de fsetpos . Em caso de falha, a função retorna um valor diferente de zero e define errno a uma das seguintes constantes manifestas (definidas em ERRNO.H): EBADF, o que significa que o arquivo não estiver acessível ou o objeto ao qual os pontos de stream não é uma estrutura de arquivo válido; ou EINVAL, que significa um valor inválido para stream ou pos foi passado. Se um parâmetro inválido é passado, essas funções invoca o manipulador inválido do parâmetro, conforme descrito em Validação do parâmetro.
Para obter mais informações sobre esses e outros códigos de retorno, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.
Comentários
A função de fsetpos define o indicador de arquivo posição para stream ao valor de pos*,* que é obtido em uma chamada anterior a fgetpos em stream*.* A função limpa o indicador de participante de Arquivo e desfazer todos os efeitos de ungetc em stream*.* Depois de chamar fsetpos, a próxima operação em stream pode ser entrada ou saída.
Requisitos
Função |
Cabeçalho necessário |
|---|---|
fsetpos |
<stdio.h> |
Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.
Exemplo
Consulte o exemplo de fgetpos.
Equivalência do .NET Framework
System::IO::FileStream::Position