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
См. также
| возвращает текущий указатель позиции файла (функция) |
|
| перемещает указатель позиции файла в определённое место в файле (функция) |
|
| перемещает указатель позиции файла в определённое место в файле (функция) |
|
Документация C++ для fgetpos |
|
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/io/fgetpos