.\" -*- 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 .\" ISO/IEC 9899:1999 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH mbsrtowcs 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ mbsrtowcs \- преобразует многобайтовую строку в строку широких символов .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBsize_t mbsrtowcs(wchar_t \fP\fIdest\fP\fB[restrict .\fP\fIlen\fP\fB], const char **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, то функция \fBmbsrtowcs\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] \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. .PP Если значение \fIdest\fP равно NULL, то \fIlen\fP игнорируется и преобразование выполняется как описано выше, исключая то, что преобразованные широкие символы не записываются в память и нет ограничения по длине. .PP В обоих перечисленных случаях, если \fIps\fP равно NULL, то используется статическое анонимное состояние, известное только функции \fBmbsrtowcs\fP(). .PP Программист должен проверить, что в \fIdest\fP есть место по крайней мере для \fIlen\fP широких символов. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" Функция \fBmbsrtowcs\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 \fBmbsrtowcs\fP() T} Безвредность в нитях T{ .na .nh MT\-Unsafe race:mbsrtowcs/!ps T} .TE .sp 1 .SH СТАНДАРТЫ C11, POSIX.1\-2008. .SH ИСТОРИЯ POSIX.1\-2001, C99. .SH ЗАМЕЧАНИЯ Поведение \fBmbsrtowcs\fP() зависит от категории \fBLC_CTYPE\fP текущей локали. .PP Передавать NULL в качестве \fIps\fP небезопасно при работе с нитями. .SH "СМ. ТАКЖЕ" \fBiconv\fP(3), \fBmbrtowc\fP(3), \fBmbsinit\fP(3), \fBmbsnrtowcs\fP(3), \fBmbstowcs\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 .