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