.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) Bruno Haible .\" .\" 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 mbsnrtowcs 3 "15 июня 2024 г." "Справочные страницы Linux 6.9.1" .SH НАИМЕНОВАНИЕ mbsnrtowcs \- преобразует многобайтовую строку в строку широких символов .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP, \fI\-lc\fP) .SH ОБЗОР .nf \fB#include \fP .P \fBsize_t mbsnrtowcs(wchar_t \fP\fIdest\fP\fB[restrict .\fP\fIlen\fP\fB], const char **restrict \fP\fIsrc\fP\fB,\fP \fB size_t \fP\fInms\fP\fB, size_t \fP\fIlen\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 Если \fIdest\fP не равно NULL, то функция \fBmbsnrtowcs\fP() преобразует не более \fInms\fP байт многобайтовой строки \fI*src\fP в строку широких символов, начинающуюся с \fIdest\fP. В \fIdest\fP будет записано не более \fIlen\fP символов. Обновляется состояние сдвига \fI*ps\fP. Эффективное выполнение преобразования осуществляется повторяющимися вызовами \fImbrtowc(dest, *src, n, ps)\fP, где \fIn\fP — некое положительное число, и пока вызов завершается успешно, увеличивая \fIdest\fP на единицу и \fI*src\fP на количество использованных байт. Преобразование может остановиться по трём причинам: .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 \fIlen\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 Если значение \fIdest\fP равно NULL, то \fIlen\fP игнорируется и преобразование выполняется как описано выше, исключая то, что преобразованные широкие символы не записываются в память и нет ограничения на длину строки назначения. .P В обоих перечисленных случаях, если \fIps\fP равно NULL, то используется статическое анонимное состояние, известное только функции \fBmbsnrtowcs\fP(). .P Программист должен проверить, что в \fIdest\fP есть место по крайней мере для \fIlen\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 .