.\" -*- 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
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wcsnrtombs 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" 
.SH ИМЯ
wcsnrtombs \- преобразует широкосимвольную строки в многобайтовую строку
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <wchar.h>\fP
.PP
\fBsize_t wcsnrtombs(char \fP\fIdest\fP\fB[restrict .\fP\fIlen\fP\fB], const wchar_t **restrict \fP\fIsrc\fP\fB,\fP
\fB                  size_t \fP\fInwc\fP\fB, size_t \fP\fIlen\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP
.fi
.PP
.RS -4
Требования макроса тестирования свойств для glibc
(см. \fBfeature_test_macros\fP(7)):
.RE
.PP
\fBwcsnrtombs\fP():
.nf
    Начиная с glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    До glibc 2.10:
        _BSD_SOURCE
.fi
.SH ОПИСАНИЕ
Функция \fBwcsnrtombs\fP() похожа на функцию \fBwcsrtombs\fP(3), исключая то, что
количество преобразуемых широких символов, начиная с \fI*src\fP, ограничено
\fInwc\fP.
.PP
Если \fIdest\fP не равно NULL, функция \fBwcsnrtombs\fP() преобразует не более
\fInwc\fP широких символов из широкосимвольной строки \fI*src\fP в многобайтовую
строку, начиная с \fIdest\fP. В \fIdest\fP будет записано максимум \fIlen\fP
байтов. Обновляется состояние смещения в \fI*ps\fP. Замена происходит путем
повторяющихся вызовов \fIwcrtomb(dest, *src, ps)\fP до тех пор, пока они
выполняются без ошибок. При этом значение \fIdest\fP увеличивается на
количество записанных байтов, а \fI*src\fP — на единицу. Замена может быть
остановлена в трех случаях:
.IP \[bu] 3
Встретившийся широкий символ нельзя представить в виде многобайтовой
последовательности (в соответствии с текущей системной локалью). В этом
случае \fI*src\fP будет указывать на неправильный широкий символ, возвращается
\fI(size_t)\ \-1\fP, а значение \fIerrno\fP становится равным \fBEILSEQ\fP.
.IP \[bu]
\fInwc\fP wide characters have been converted without encountering a null wide
character (L\[aq]\e0\[aq]), or the length limit forces a stop.  In this
case, \fI*src\fP is left pointing to the next wide character to be converted,
and the number of bytes written to \fIdest\fP is returned.
.IP \[bu]
The wide\-character string has been completely converted, including the
terminating null wide character (which has the side effect of bringing back
\fI*ps\fP to the initial state).  In this case, \fI*src\fP is set to NULL, and the
number of bytes written to \fIdest\fP, excluding the terminating null byte
(\[aq]\e0\[aq]), is returned.
.PP
Если значение \fIdest\fP равно NULL, то \fIlen\fP игнорируется и преобразование
выполняется как описано выше, исключая то, что преобразованные байты не
записываются в память и нет ограничения на длину строки назначения.
.PP
В обоих перечисленных случаях, если \fIps\fP равно NULL, то используется
статическое анонимное состояние, известное только функции \fBwcsnrtombs\fP().
.PP
Программист должен быть уверен, что в \fIdest\fP достаточно места для, по
крайней мере, \fIlen\fP байт.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
Функция \fBwcsrntombs\fP() возвращает количество байт в полученной
многобайтовой последовательности, не включая завершающий байт null. Если
встречается широкий символ, который невозможно преобразовать, возвращается
\fI(size_t)\ \-1\fP и значение \fIerrno\fP становится равным \fBEILSEQ\fP.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lb lb lbx
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBwcsnrtombs\fP()
T}	Безвредность в нитях	T{
.na
.nh
MT\-Unsafe race:wcsnrtombs/!ps
T}
.TE
.sp 1
.SH СТАНДАРТЫ
POSIX.1\-2008.
.SH ЗАМЕЧАНИЯ
Поведение \fBwcsnrtombs\fP() зависит от категории \fBLC_CTYPE\fP текущей локали.
.PP
Передавать NULL в качестве \fIps\fP небезопасно при работе с нитями.
.SH "СМ. ТАКЖЕ"
\fBiconv\fP(3), \fBmbsinit\fP(3), \fBwcsrtombs\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Azamat Hackimov <azamat.hackimov@gmail.com>
и
Yuri Kozlov <yuray@komyakino.ru>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .