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.