База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

fgetpos — функция за поток в C23

`fgetpos(stream, pos)` от `<stdio.h>` запазва текущото състояние на позицията на отворен поток в обекта `fpos_t`, посочен от `pos`. Връща нула при успех и ненулева стойност при грешка; състоянието е предназначено за по-късен `fsetpos`.

Версия: C23

Синтаксис

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

fgetpos(stream, pos) от <stdio.h> запазва текущото състояние на позицията на отворен поток в обекта fpos_t, посочен от pos. Връща нула при успех и ненулева стойност при грешка; състоянието е предназначено за по-късен fsetpos.

Примерът записва ABC, прочита A, запазва позицията с fgetpos, прочита B, възстановява я с fsetpos и пак прочита B. 1 B B показва точно запазване и възстановяване на състоянието.

fpos_t не е задължително аритметичен тип или брой байтове; може да включва състояние за многобайтов анализ. Не извършвайте аритметика и не го сериализирайте като преносим offset. Двата указателя трябва да са валидни и pos да живее до употребата. При грешка резултатът е ненулев и реализацията пази положителна стойност в errno.

Примери

#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;
}

Резултат

1 B B

Примерът записва `ABC`, прочита `A`, запазва позицията с `fgetpos`, прочита `B`, възстановява я с `fsetpos` и пак прочита `B`. `1 B B` показва точно запазване и възстановяване на състоянието.

Източници