NAZWA

       fgetwc, getwc - odczytuje szeroki znak ze strumienia FILE

SKŁADNIA

       #include <stdio.h>
       #include <wchar.h>

       wint_t fgetwc(FILE *stream);
       wint_t getwc(FILE *stream);

OPIS

       Funkcja  fgetwc() jest szerokoznakowym odpowiednikiem funkcji fgetc(3). Wczytuje szeroki znak ze stream i
       zwraca go. W razie natrafienia na koniec strumienia lub gdy ferror(stream) stanie się  prawdziwe,  zwraca
       WEOF. Jeśli wystąpi błąd konwersji znaku, ustawia errno na EILSEQ i również zwraca WEOF.

       Funkcja  lub makro getwc() zachowuje się identycznie jak fgetwc(). Może być  zaimplementowane jako makro,
       więc może wskutek  tego  rozwijać  swój  argument  więcej  niż  raz.  Nie  ma  żadnego  powodu,  aby  tej
       funkcji/makra używać.

       Informacje o nieblokujących odpowiednikach znajdują się w unlocked_stdio(3).

WARTOŚĆ ZWRACANA

       Funkcja fgetwc() zwraca następny szeroki znak pobrany ze strumienia lub WEOF. W przypadku błędu ustawiane
       jest errno, wskazując na przyczynę błędu.

BŁĘDY

       Oprócz zwykłych jest jeszcze

       EILSEQ Dane otrzymane ze strumienia wejściowego nie tworzą prawidłowego znaku.

ZGODNE Z

       C99, POSIX.1-2001.

UWAGI

       Zachowanie fgetwc() zależy od kategorii LC_CTYPE bieżących ustawień regionalnych.

       W  przypadku  nieprzekazania dodatkowych informacji przy wywołaniu fopen(3) rozsądne jest oczekiwanie, że
       fgetwc() faktycznie odczyta wielobajtowy łańcuch ze strumienia i przetworzy go na szeroki znak.

ZOBACZ TAKŻE

       fgetws(3), fputwc(3), ungetwc(3), unlocked_stdio(3)

O STRONIE

       Angielska wersja tej strony pochodzi z wydania 3.71 projektu Linux man-pages. Opis  projektu,  informacje
       dotyczące   zgłaszania   błędów,   oraz   najnowszą   wersję   oryginału   można   znaleźć   pod  adresem
       http://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami polskiego tłumaczenia  niniejszej  strony  podręcznika  man  są:  Andrzej  Krzysztofowicz  (PTM)
       <ankry@mif.pg.gda.pl> i Robert Luberda <robert@debian.org>.

       Polskie  tłumaczenie  jest  częścią  projektu  manpages-pl;  uwagi,  pomoc,  zgłaszanie błędów na stronie
       http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją  3.71 oryginału.

GNU                                                2013-04-19                                          FGETWC(3)