Namespaces
Variants

fgetpos

De es.cppreference.net
< c | io
 
 
Entrada/salida de archivos
Tipos y objetos
        
Funciones
Acceso a archivos
(C95)
Entrada/salida sin formato
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)

Entrada formateada
Entrada/salida directa
Salida formateada
Posicionamiento de archivos
Manejo de errores
Operaciones sobre archivos
 
Definido en el encabezado <stdio.h>
int fgetpos( FILE* stream, fpos_t* pos );
(hasta C99)
int fgetpos( FILE* restrict stream, fpos_t* restrict pos );
(desde C99)

Obtiene el indicador de posición del archivo y el estado de análisis actual (si lo hay) para el flujo de archivo stream y los almacena en el objeto apuntado por pos. El valor almacenado solo es significativo como entrada para fsetpos.

Parámetros

stream - flujo de archivo a examinar
pos - puntero a un fpos_t para almacenar el indicador de posición del archivo

Valor de retorno

0 en caso de éxito, valor distinto de cero en caso contrario.

Ejemplo

#include <assert.h>
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    // prepare a file holding 4 values of type double
    enum {SIZE = 4};
    FILE* fp = fopen("test.bin", "wb");
    assert(fp);
    int rc = fwrite((double[SIZE]){1.1, 2.2, 3.3, 4.4}, sizeof(double), SIZE, fp);
    assert(rc == SIZE);
    fclose(fp);

    // demo using fsetpos to return to the beginning of a file
    fp = fopen("test.bin", "rb");
    fpos_t pos;
    fgetpos(fp, &pos);               // store start of file in pos
    double d;
    rc = fread(&d, sizeof d, 1, fp); // read the first double
    assert(rc == 1);
    printf("First value in the file: %.1f\n", d);
    fsetpos(fp,&pos);                // move file position back to the start of the file
    rc = fread(&d, sizeof d, 1, fp); // read the first double again
    assert(rc == 1);
    printf("First value in the file again: %.1f\n", d);
    fclose(fp);

    // demo error handling
    rc = fsetpos(stdin, &pos);
    if (rc)
        perror("could not fsetpos stdin");
}

Salida:

First value in the file: 1.1
First value in the file again: 1.1
could not fsetpos stdin: Illegal seek

Referencias

  • Estándar C23 (ISO/IEC 9899:2024):
  • 7.21.9.1 La función fgetpos (p: TBD)
  • Estándar C17 (ISO/IEC 9899:2018):
  • 7.21.9.1 La función fgetpos (p: TBD)
  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.21.9.1 La función fgetpos (p: 336)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.19.9.1 La función fgetpos (p: 302)
  • Estándar C89/C90 (ISO/IEC 9899:1990):
  • 4.9.9.1 La función fgetpos

Véase también

devuelve el indicador de posición actual del archivo
(función)
mueve el indicador de posición del archivo a una ubicación específica en un archivo
(función)
mueve el indicador de posición del archivo a una ubicación específica en un archivo
(función)