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¶
Funkcja
fgetws() jest szerokoznakowym odpowiednikiem funkcji
fgets(3). Wczytuje ł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 czytanie, gdy natrafi na szeroki
znak końca linii. Znak ten jest wczytywany do tablicy. Kończy
również w razie napotkania końca strumienia.
Programista musi zapewnić w
ws miejsce na co najmniej
n
szerokich znaków.
Informacje o nieblokujących odpowiednikach 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¶
C99, POSIX.1-2001.
UWAGI¶
Zachowanie
fgetws() 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
fgetws()
faktycznie odczyta wielobajtowy łańcuch ze strumienia i
przetworzy go na szeroki znak.
Na funkcji tej nie można polegać, gdyż nie pozwala na
prawidłowe traktowanie szerokich znaków null, które
mogą się pojawić na wejściu.
ZOBACZ TAKŻE¶
fgetwc(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.