.\" -*- coding: UTF-8 -*- '\" t .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH mbsnrtowcs 3 "28 июня 2025 г." "Справочные страницы Linux 6.15" .SH НАИМЕНОВАНИЕ mbsnrtowcs \- преобразует многобайтовую строку в строку широких символов .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP,\ \fI\-lc\fP) .SH ОБЗОР .nf \fB#include \fP .P \fBsize_t mbsnrtowcs(\fPsize_t size; \fB wchar_t \fP\fIdest\fP\fB[restrict \fP\fIsize\fP\fB], const char **restrict \fP\fIsrc\fP\fB,\fP \fB size_t \fP\fInms\fP\fB, size_t \fP\fIsize\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP .fi .P .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .P \fBmbsnrtowcs\fP(): .nf Начиная с glibc 2.10: _POSIX_C_SOURCE >= 200809L До glibc 2.10: _BSD_SOURCE .fi .SH ОПИСАНИЕ Функция \fBmbsnrtowcs\fP() похожа на функцию \fBmbsrtowcs\fP(3), исключая то, что количество преобразуемых байт, начиная с \fI*src\fP, ограничено \fInms\fP байтами. .P If \fIdest\fP is not NULL, the \fBmbsnrtowcs\fP() function converts at most \fInms\fP bytes from the multibyte string \fI*src\fP to a wide\-character string starting at \fIdest\fP. At most \fIsize\fP wide characters are written to \fIdest\fP. The shift state \fI*ps\fP is updated. The conversion is effectively performed by repeatedly calling \fImbrtowc(dest, *src, n, ps)\fP where \fIn\fP is some positive number, as long as this call succeeds, and then incrementing \fIdest\fP by one and \fI*src\fP by the number of bytes consumed. The conversion can stop for three reasons: .IP \[bu] 3 Во входных данных обнаружена неправильная многобайтовая последовательность. В этом случае \fI*src\fP по\-прежнему указывает на неправильную многобайтовую последовательность, возвращается \fI(size_t)\ \-1\fP и \fIerrno\fP присваивается \fBEILSEQ\fP. .IP \[bu] The \fInms\fP limit forces a stop, or \fIsize\fP non\-L\[aq]\[rs]0\[aq] wide characters have been stored at \fIdest\fP. In this case, \fI*src\fP is left pointing to the next multibyte sequence to be converted, and the number of wide characters written to \fIdest\fP is returned. .IP \[bu] The multibyte string has been completely converted, including the terminating null wide character (\[aq]\[rs]0\[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 wide characters written to \fIdest\fP, excluding the terminating null wide character, is returned. .P Если входной буфер заканчивается неполным символом, в POSIX.1 не указано где остановится преобразование — в конце предыдущего символа (если есть) или в конце входного буфера. В реализации glibc принят первый вариант. .P If \fIdest\fP is NULL, \fIsize\fP is ignored, and the conversion proceeds as above, except that the converted wide characters are not written out to memory, and that no destination size limit exists. .P В обоих перечисленных случаях, если \fIps\fP равно NULL, то используется статическое анонимное состояние, известное только функции \fBmbsnrtowcs\fP(). .P The programmer must ensure that there is room for at least \fIsize\fP wide characters at \fIdest\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" Функция \fBmbsnrtowcs\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 \fBmbsnrtowcs\fP() T} Безвредность в нитях T{ .na .nh MT\-Unsafe race:mbsnrtowcs/!ps T} .TE .SH СТАНДАРТЫ POSIX.1\-2008. .SH ПРИМЕЧАНИЯ Поведение \fBmbsnrtowcs\fP() зависит от категории \fBLC_CTYPE\fP текущей локали. .P Передавать NULL в качестве \fIps\fP небезопасно при работе с нитями. .SH "СМОТРИТЕ ТАКЖЕ" \fBiconv\fP(3), \fBmbrtowc\fP(3), \fBmbsinit\fP(3), \fBmbsrtowcs\fP(3) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) aereiae , Alexey , Azamat Hackimov , Dmitriy S. Seregin , Dmitry Bolkhovskikh , ITriskTI , Max Is , Yuri Kozlov , Иван Павлов , Малянов Евгений Викторович и Kirill Rekhov . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .