FGETWS(3)

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/.