Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

fsetpos — função de fluxo C23

`fsetpos(stream, pos)` de `<stdio.h>` restaura o indicador de posição e, se existir, o objeto `mbstate_t` a partir de valor guardado por `fgetpos` bem-sucedido num fluxo associado ao mesmo ficheiro. Devolve `0` no sucesso e valor não zero na falha.

Versão: C23

Sintaxe

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

fsetpos(stream, pos) de <stdio.h> restaura o indicador de posição e, se existir, o objeto mbstate_t a partir de valor guardado por fgetpos bem-sucedido num fluxo associado ao mesmo ficheiro. Devolve 0 no sucesso e valor não zero na falha.

O exemplo escreve ABCDE, guarda a posição depois de AB, lê até ao fim e observa feof == 1. Depois fsetpos restaura o estado; 1 0 C mostra que EOF foi limpo e C voltou a ser lido na posição pretendida.

O sucesso desfaz efeitos de ungetc, limpa o indicador de fim e permite que a operação seguinte num fluxo de atualização seja leitura ou escrita. fpos_t é opaco: não faças aritmética nem transfiras valores entre ficheiros. Se leitura ou escrita falhar, o indicador de erro é ativado; a função devolve não zero e guarda em errno um valor positivo dependente da implementação.

Exemplos

#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("ABCDE",stream)==EOF){fclose(stream);return 1;}rewind(stream);if(fgetc(stream)!='A'||fgetc(stream)!='B'){fclose(stream);return 1;}fpos_t pos;if(fgetpos(stream,&pos)!=0){fclose(stream);return 1;}while(fgetc(stream)!=EOF){}int before=feof(stream)!=0;if(fsetpos(stream,&pos)!=0){fclose(stream);return 1;}int after=feof(stream)!=0,character=fgetc(stream);printf("%d %d %c\n",before,after,character);return fclose(stream)==0?0:1;}

Resultado

1 0 C

O exemplo escreve `ABCDE`, guarda a posição depois de `AB`, lê até ao fim e observa `feof == 1`. Depois `fsetpos` restaura o estado; `1 0 C` mostra que EOF foi limpo e `C` voltou a ser lido na posição pretendida.

Fontes