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

CKTIS / C

fgetpos — função de fluxo C23

`fgetpos(stream, pos)` de `<stdio.h>` guarda o estado de posição atual de um fluxo aberto no objeto `fpos_t` indicado por `pos`. Devolve zero no sucesso e valor não zero na falha; o estado destina-se a um `fsetpos` posterior.

Versão: C23

Sintaxe

int fgetpos(FILE * restrict stream, fpos_t * restrict pos);

fgetpos(stream, pos) de <stdio.h> guarda o estado de posição atual de um fluxo aberto no objeto fpos_t indicado por pos. Devolve zero no sucesso e valor não zero na falha; o estado destina-se a um fsetpos posterior.

O exemplo escreve ABC, lê A, guarda a posição com fgetpos, lê B, restaura-a com fsetpos e volta a ler B. 1 B B mostra captura e reposição exatas do estado.

fpos_t não tem de ser aritmético nem contar bytes; pode incluir estado de análise multibyte. Não faças aritmética nele nem o serializes como offset portável. Ambos os ponteiros têm de ser válidos e pos viver até ao uso. Na falha o resultado é não zero e a implementação guarda um valor positivo em errno.

Exemplos

#include <stdio.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    if (fputs("ABC", stream) == EOF) { fclose(stream); return 1; }
    rewind(stream);
    if (fgetc(stream) != 'A') { fclose(stream); return 1; }
    fpos_t position;
    int saved = fgetpos(stream, &position) == 0;
    int first = fgetc(stream);
    if (!saved || fsetpos(stream, &position) != 0) { fclose(stream); return 1; }
    int again = fgetc(stream);
    printf("%d %c %c\n", saved, first, again);
    return fclose(stream) == 0 ? 0 : 1;
}

Resultado

1 B B

O exemplo escreve `ABC`, lê `A`, guarda a posição com `fgetpos`, lê `B`, restaura-a com `fsetpos` e volta a ler `B`. `1 B B` mostra captura e reposição exatas do estado.

Fontes