.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification
.\"     http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fgetws 3 "2 мая 2024 г." "Linux man\-pages 6.8" 
.SH ИМЯ
fgetws \- читает строку широких символов из потока FILE
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <wchar.h>\fP
.P
\fBwchar_t *fgetws(wchar_t \fP\fIws\fP\fB[restrict .\fP\fIn\fP\fB], int \fP\fIn\fP\fB, FILE *restrict \fP\fIstream\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
The \fBfgetws\fP()  function is the wide\-character equivalent of the
\fBfgets\fP(3)  function.  It reads a string of at most \fIn\-1\fP wide characters
into the wide\-character array pointed to by \fIws\fP, and adds a terminating
null wide character (L\[aq]\e0\[aq]).  It stops reading wide characters
after it has encountered and stored a newline wide character.  It also stops
when end of stream is reached.
.P
Программист должен убедиться в том, что выделил для \fIws\fP память,
достаточную для записи не менее \fIn\fP широких символов.
.P
Неблокирующий аналог смотрите в \fBunlocked_stdio\fP(3).
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
Функция \fBfgetws\fP() в случае удачного выполнения возвращает \fIws\fP. Если
достигнут конец потока или возникает ошибка, то возвращается NULL.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBfgetws\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.SH СТАНДАРТЫ
C11, POSIX.1\-2008.
.SH ИСТОРИЯ
POSIX.1\-2001, C99.
.SH ПРИМЕЧАНИЯ
Поведение \fBfgetws\fP() зависит от категории \fBLC_CTYPE\fP текущей локали.
.P
Из\-за отсутствия дополнительной информации, передаваемой в \fBfopen\fP(3),
закономерно ожидать, что \fBfgetws\fP() на самом деле читает многобайтовую
строку из потока, а затем преобразует её в широкую строку.
.P
Данная функция  ненадёжна, так как не позволяет правильно обработать
ситуацию, когда во входных данных появляется широкий символ null.
.SH "СМОТРИТЕ ТАКЖЕ"
\fBfgetwc\fP(3), \fBunlocked_stdio\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства разработал
Azamat Hackimov <azamat.hackimov@gmail.com>,
Dmitry Bolkhovskikh <d20052005@yandex.ru>,
Yuri Kozlov <yuray@komyakino.ru>
и
Иван Павлов <pavia00@gmail.com>
.
.PP
Этот перевод является свободной программной документацией; он распространяется
на условиях общедоступной лицензии GNU (GNU General Public License - GPL,
.UR https://www.gnu.org/licenses/gpl-3.0.html
.UE
версии 3 или более поздней) в отношении
авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
.PP
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста,
сообщите об этом разработчику по его адресу электронной почты или по адресу
.MT <debian-l10n-russian@lists.debian.org>
списка рассылки русских переводчиков
.ME .