.\" -*- 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 "31 октября 2023 г." "Linux man\-pages 6.06" .SH ИМЯ mbsnrtowcs \- преобразует многобайтовую строку в строку широких символов .SH LIBRARY Standard C library (\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]\e0\[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]\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 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 , Иван Павлов и Малянов Евгений Викторович . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .