Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

fgetpos — función de flujo de C23

`fgetpos(stream, pos)` de `<stdio.h>` guarda el estado de posición actual de un flujo abierto en el objeto `fpos_t` indicado por `pos`. Devuelve cero al tener éxito y un valor distinto de cero al fallar; el estado se destina a un `fsetpos` posterior.

Versión: C23

Sintaxis

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

fgetpos(stream, pos) de <stdio.h> guarda el estado de posición actual de un flujo abierto en el objeto fpos_t indicado por pos. Devuelve cero al tener éxito y un valor distinto de cero al fallar; el estado se destina a un fsetpos posterior.

El ejemplo escribe ABC, lee A, guarda la posición con fgetpos, lee B, la restaura con fsetpos y vuelve a leer B. 1 B B muestra la captura y restauración exactas del estado.

fpos_t no tiene que ser aritmético ni contar bytes; puede incluir estado de análisis multibyte. No hagas aritmética con él ni lo serialices como offset portable. Ambos punteros deben ser válidos y pos vivir hasta su uso. Al fallar, el resultado es no cero y la implementación guarda un valor positivo en errno.

Ejemplos

#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

El ejemplo escribe `ABC`, lee `A`, guarda la posición con `fgetpos`, lee `B`, la restaura con `fsetpos` y vuelve a leer `B`. `1 B B` muestra la captura y restauración exactas del estado.

Fuentes