fgetws(3) Library Functions Manual fgetws(3) NAZWA fgetws - odczytuje lancuch szerokich znakow ze strumienia FILE BIBLIOTEKA Standardowa biblioteka C (libc, -lc) SKLADNIA #include wchar_t *fgetws(wchar_t ws[restrict .n], int n, FILE *restrict stream); OPIS The fgetws() function is the wide-character equivalent of the fgets(3) function. It reads a string of at most n-1 wide characters into the wide-character array pointed to by ws, and adds a terminating null wide character (L'\0'). It stops reading wide characters after it has encountered and stored a newline wide character. It also stops when end of stream is reached. Programista musi zapewnic w ws miejsce na co najmniej n szerokich znakow. Informacje o nieblokujacych odpowiednikach znajduja sie w unlocked_stdio(3). WARTOSC ZWRACANA Funkcja fgetws() w przypadku pomyslnego zakonczenia zwraca ws. W razie natrafienia na koniec strumienia lub wystapienia bledu zwraca NULL. ATRYBUTY Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w podreczniku attributes(7). +---------------------------+--------------------------+---------------+ |Interfejs | Atrybut | Wartosc | +---------------------------+--------------------------+---------------+ |fgetws() | Bezpieczenstwo watkowe | MT-bezpieczne | +---------------------------+--------------------------+---------------+ STANDARDY C11, POSIX.1-2008. HISTORIA POSIX.1-2001, C99. UWAGI Zachowanie fgetws() zalezy od kategorii LC_CTYPE biezacych ustawien regionalnych. W przypadku nieprzekazania dodatkowych informacji przy wywolaniu fopen(3) rozsadne jest oczekiwanie, ze fgetws() faktycznie odczyta wielobajtowy lancuch ze strumienia i przetworzy go na szeroki znak. Na funkcji tej nie mozna polegac, gdyz nie pozwala na prawidlowe traktowanie szerokich znakow null, ktore moga sie pojawic na wejsciu. ZOBACZ TAKZE fgetwc(3), unlocked_stdio(3) TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Andrzej Krzysztofowicz , Robert Luberda i Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . Linux man-pages 6.06 31 pazdziernika 2023 r. fgetws(3)