Spec-Zone.ru › C

fgetpos

Определено в заголовке <stdio.h>
int fgetpos( FILE          *stream, fpos_t          *pos );
(до C99)
int fgetpos( FILE *restrict stream, fpos_t *restrict pos );
(с C99)

Получает указатель позиции файла и текущее состояние разбора (если таковое имеется) для потока файла stream и сохраняет их в объекте, на который указывает pos. Сохранённое значение имеет смысл только как входное значение для fsetpos.

Параметры

stream - поток файла для проверки
pos - указатель на объект fpos_t для сохранения указателя позиции файла

Возвращаемое значение

значение 0 при успешном выполнении, ненулевое значение в противном случае.

Пример

#include <stdio.h>
#include <stdlib.h>
#include <assert.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");
}

Вывод:

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

Ссылки

  • Стандарт C11 (ISO/IEC 9899:2011):
    • 7.21.9.1 Функция fgetpos (с. 336)
  • Стандарт C99 (ISO/IEC 9899:1999):
    • 7.19.9.1 Функция fgetpos (с. 302)
  • Стандарт C89/C90 (ISO/IEC 9899:1990):
    • 4.9.9.1 Функция fgetpos

См. также

ftell
возвращает текущий указатель позиции файла
(функция)
fseek
перемещает указатель позиции файла в определённое место в файле
(функция)
fsetpos
перемещает указатель позиции файла в определённое место в файле
(функция)
Документация C++ для fgetpos

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/io/fgetpos

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API