NAZWA

       fgetws - odczytuje łańcuch szerokich znaków ze strumienia FILE

SKŁADNIA

       #include <wchar.h>

       wchar_t *fgetws(wchar_t *ws, int n, FILE *stream);

OPIS

        Uwaga! To tłumaczenie może być nieaktualne!

       Funkcja  fgetws  jest  szerokoznakowym odpowiednikiem funkcji fgets.  Wczytuje ona łańcuch
       zawierający co najwyżej n-1 szerokich znaków do tablicy szerokich znaków wskazywanej przez
       ws  oraz  dodaje znak końca łańcucha L'\0'. Kończy ona czytanie, gdy natrafi na znak końca
       linii. Znak ten jest wczytywany do tablicy. Kończy ona  również  w  razie  natrafienia  na
       koniec strumienia.

       Programista musi zapewnić w ws miejsce na co najmniej n szerokich znaków.

       Informacje o nieblokującym odpowiedniku znajdują się w unlocked_stdio(3).

WARTOŚĆ ZWRACANA

       Funkcja  fgetws,  w  przypadku  pomyślnego zakończenia, zwraca ws.  W razie natrafienia na
       koniec strumienia lub wystąpienia błędu, zwraca NULL.

ZGODNE Z

       ISO/ANSI C, UNIX98

UWAGI

       Zachowanie fgetws zależy od ustawienia kategorii LC_CTYPE aktualnego locale.

       W przypadku nieprzekazania dodatkowych informacji  przy  wywołaniu  fopen,  rozsądne  jest
       oczekiwanie,  że fgetws faktycznie odczyta wielobajtowy łańcuch ze strumienia i przetworzy
       go na łańcuch szerokich znaków.

       Funkcja ta jest niepewna, gdyż nie pozwala na prawidłowe traktowanie szerokich znaków NUL,
       które mogą się pojawić na wejściu.

ZOBACZ TAKŻE

       fgetwc(3) unlocked_stdio(3)

INFORMACJE O TŁUMACZENIU

       Powyższe  tłumaczenie  pochodzi  z nieistniejącego już Projektu Tłumaczenia Manuali i może
       nie być aktualne. W  razie  zauważenia  różnic  między  powyższym  opisem  a  rzeczywistym
       zachowaniem  opisywanego  programu  lub  funkcji,  prosimy  o  zapoznanie się z oryginalną
       (angielską) wersją strony podręcznika za pomocą polecenia:

              man --locale=C 3 fgetws

       Prosimy o pomoc w aktualizacji stron man - więcej informacji  można  znaleźć  pod  adresem
       http://sourceforge.net/projects/manpages-pl/.