CKTIS / C
fgetc — funkcja strumieniowa C23
`fgetc(stream)` z `<stdio.h>` odczytuje następny znak ze strumienia wejściowego, przesuwa pozycję i zwraca bajt potraktowany jako `unsigned char`, a następnie przekształcony do `int`. Przy końcu pliku albo błędzie zwraca `EOF` i ustawia odpowiedni wskaźnik strumienia.
Wersja: C23
Składnia
int fgetc(FILE *stream);fgetc(stream) z <stdio.h> odczytuje następny znak ze strumienia wejściowego, przesuwa pozycję i zwraca bajt potraktowany jako unsigned char, a następnie przekształcony do int. Przy końcu pliku albo błędzie zwraca EOF i ustawia odpowiedni wskaźnik strumienia.
Przykład zapisuje znak A do tmpfile(), przewija i dwukrotnie wywołuje fgetc. Wynik 1 1 1 0 potwierdza pierwszy znak, EOF przy drugiej próbie, ustawiony wskaźnik końca pliku oraz brak wskaźnika błędu.
Zawsze zapisuj wynik w int; wcześniejsze zwężenie do char może pomylić poprawny bajt z EOF, szczególnie gdy char jest ze znakiem. Po wyniku EOF rozróżnij przyczynę przez feof i ferror. W trybie tekstowym środowisko może tłumaczyć reprezentację znaków, a ungetc może odłożyć znak bez cofania dowolnej liczby bajtów.
Przykłady
#include <stdio.h>
int main(void) {
FILE *stream = tmpfile();
if (stream == NULL) return 1;
if (fputc('A', stream) == EOF) { fclose(stream); return 1; }
rewind(stream);
int first = fgetc(stream);
int second = fgetc(stream);
printf("%d %d %d %d\n", first == 'A', second == EOF, feof(stream) != 0, ferror(stream) != 0);
return fclose(stream) == 0 ? 0 : 1;
}
Wynik
1 1 1 0
Przykład zapisuje znak `A` do `tmpfile()`, przewija i dwukrotnie wywołuje `fgetc`. Wynik `1 1 1 0` potwierdza pierwszy znak, `EOF` przy drugiej próbie, ustawiony wskaźnik końca pliku oraz brak wskaźnika błędu.