Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

fputc — funkcja strumieniowa C23

`fputc(c, stream)` z `<stdio.h>` zapisuje do strumienia znak odpowiadający wartości `c` przekształconej do `unsigned char`. Przy powodzeniu zwraca zapisaną wartość jako `unsigned char` przekształcone do `int`; przy błędzie zwraca `EOF` i ustawia wskaźnik błędu.

Wersja: C23

Składnia

int fputc(int c, FILE *stream);

fputc(c, stream) z <stdio.h> zapisuje do strumienia znak odpowiadający wartości c przekształconej do unsigned char. Przy powodzeniu zwraca zapisaną wartość jako unsigned char przekształcone do int; przy błędzie zwraca EOF i ustawia wskaźnik błędu.

Przykład zapisuje przez fputc znak A i znak nowego wiersza do tmpfile(), przewija i odczytuje oba bajty. Wynik 1 65 10 pokazuje udany status pierwszego zapisu oraz wartości rzeczywiście odzyskane ze strumienia.

Sprawdzaj zwracaną wartość po każdym krytycznym zapisie; samo buforowanie może odsunąć późniejszy błąd do fflush lub fclose. Argument spoza zakresu unsigned char jest najpierw konwertowany, więc nie służy do zapisu całego int. W trybie tekstowym środowisko może tłumaczyć znak nowego wiersza.

Przykłady

#include <stdio.h>
int main(void){FILE*s=tmpfile();if(!s)return 1;int ok=fputc('A',s)=='A';if(fputc('\n',s)==EOF){fclose(s);return 1;}rewind(s);int a=fgetc(s),nl=fgetc(s);printf("%d %d %d\n",ok,a,nl);return fclose(s)==0?0:1;}

Wynik

1 65 10

Przykład zapisuje przez `fputc` znak `A` i znak nowego wiersza do `tmpfile()`, przewija i odczytuje oba bajty. Wynik `1 65 10` pokazuje udany status pierwszego zapisu oraz wartości rzeczywiście odzyskane ze strumienia.

Źródła