.\" -*- 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
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wcsrtombs 3 "5 февраля 2023 г." "Linux man\-pages 6.03" 
.SH ИМЯ
wcsrtombs \- преобразует широкосимвольную строку в многобайтовую строку
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <wchar.h>\fP
.PP
\fBsize_t wcsrtombs(char \fP\fIdest\fP\fB[restrict .\fP\fIlen\fP\fB], const wchar_t **restrict \fP\fIsrc\fP\fB,\fP
\fB                 size_t \fP\fIlen\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
Если \fIdest\fP не равно NULL, функция \fBwcsrtombs\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]
Остановка при достижении ограничения длины. В этом случае \fI*src\fP также
будет указывать на следующий широкий символ, подлежащий преобразованию, и
возвращается количество байтов, записанных в \fIdest\fP.
.IP \[bu]
The wide\-character string has been completely converted, including the
terminating null wide character (L\[aq]\e0\[aq]), 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, то используется
статическое анонимное состояние, известное только функции \fBwcsrtombs\fP().
.PP
Программист должен быть уверен, что в \fIdest\fP достаточно места для, по
крайней мере, \fIlen\fP байт.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
Функция \fBwcsrtombs\fP() возвращает количество байт в полученной многобайтовой
последовательности, не включая завершающий байт null. Если встречается
широкий символ, который невозможно преобразовать, возвращается \fI(size_t)\ \-1\fP и значение \fIerrno\fP становится равным \fBEILSEQ\fP.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lb lb lbx
l l l.
Интерфейс	Атрибут	Значение
T{
\fBwcsrtombs\fP()
T}	Безвредность в нитях	T{
MT\-Unsafe race:wcsrtombs/!ps
T}
.TE
.hy
.ad
.sp 1
.SH СТАНДАРТЫ
POSIX.1\-2001, POSIX.1\-2008, C99.
.SH ЗАМЕЧАНИЯ
Поведение \fBwcsrtombs\fP() зависит от категории \fBLC_CTYPE\fP текущей локали.
.PP
Передавать NULL в качестве \fIps\fP небезопасно при работе с нитями.
.SH "СМ. ТАКЖЕ"
\fBiconv\fP(3), \fBmbsinit\fP(3), \fBwcrtomb\fP(3), \fBwcsnrtombs\fP(3), \fBwcstombs\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 .