fgetws - odczytuje łańcuch szerokich znaków ze strumienia
FILE
Standardowa biblioteka C (
libc,
-lc)
#include <wchar.h>
wchar_t *fgetws(wchar_t ws[restrict .n], int n, FILE *restrict stream);
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 zapewnić w
ws miejsce na co najmniej
n
szerokich znaków.
Informacje o nieblokujących odpowiednikach znajdują się w
unlocked_stdio(3).
Funkcja
fgetws() w przypadku pomyślnego zakończenia zwraca
ws. W razie natrafienia na koniec strumienia lub wystąpienia
błędu zwraca NULL.
Informacje o pojęciach używanych w tym rozdziale można
znaleźć w podręczniku
attributes(7).
| Interfejs |
Atrybut |
Wartość |
|
fgetws() |
Bezpieczeństwo wątkowe |
MT-Safe |
POSIX.1-2001, POSIX.1-2008, C99.
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.
fgetwc(3),
unlocked_stdio(3)
Autorami polskiego tłumaczenia niniejszej strony podręcznika
są: Andrzej Krzysztofowicz <
[email protected]>, Robert
Luberda <
[email protected]> i Michał Kułach
<
[email protected]>
Niniejsze tłumaczenie jest wolną dokumentacją.
Bliższe informacje o warunkach licencji można uzyskać
zapoznając się z
GNU
General Public License w wersji 3 lub nowszej. Nie przyjmuje się
ŻADNEJ ODPOWIEDZIALNOŚCI.
Błędy w tłumaczeniu strony podręcznika prosimy
zgłaszać na adres listy dyskusyjnej
[email protected]