FGETWS(3)

НАЗВАНИЕ
fgetws - считывает строку широких символов из потока FILE.

СИНТАКСИС
#include <wchar.h>

wchar_t *fgetws (wchar_t *ws, int n, FILE *stream);

ОПИСАНИЕ
Функция fgetws - это эквивалент fgets, но работающий со строками широких символов. Она читает строку из не более чем n-1 широких символов и записывает ее в массив широких символов, обозначенный указателем ws и заканчивающийся символом '\0'. Чтение прекращается, если считано необходимое количество символов, обнаружен символ конца строки или достигнут конец входящего потока.

Программист должен убедиться в том, что выделил ws достаточно памяти: как минимум, объем памяти, необходимый для n широких символов.

ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
Функция fgetws в случае удачного завершения вызова возвращает ws. Если достигнут конец потока, возвращается NULL и устанавливается код ошибки.

СООТВЕТСТВИЕ СТАНДАРТАМ
ISO/ANSI C, UNIX98

СМ. ТАКЖЕ
fgetwc(3)

ЗАМЕЧАНИЯ
Поведение fgetws зависит от категории LC_CTYPE системной локали.