.\" -*- coding: UTF-8 -*- .\" Copyright (c) Bruno Haible .\" .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA) .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" published by the Free Software Foundation; either version 2 of .\" the License, or (at your option) any later version. .\" %%%LICENSE_END .\" .\" 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 "6 марта 2019 г." GNU "Руководство программиста Linux" .SH ИМЯ mbsrtowcs \- преобразует многобайтовую строку в строку широких символов .SH СИНТАКСИС .nf \fB#include \fP .PP \fBsize_t mbsrtowcs(wchar_t *\fP\fIdest\fP\fB, const char **\fP\fIsrc\fP\fB,\fP \fB size_t \fP\fIlen\fP\fB, mbstate_t *\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 1. 3 Во входных данных обнаружена неправильная многобайтовая последовательность. В этом случае \fI*src\fP по\-прежнему указывает на неправильную многобайтовую последовательность, возвращается \fI(size_t)\ \-1\fP и \fIerrno\fP присваивается \fBEILSEQ\fP. .IP 2. В \fIdest\fP было сохранено \fIlen\fP не равных L\(aq\e0\(aq широких символов. В этом случае \fI*src\fP продолжит указывать на следующую непреобразованную многобайтовую последовательность и будет возвращено количество широких символов, записанных в \fIdest\fP. .IP 3. Многобайтовая строка была полностью преобразована, включая завершающий широкий символ null (\(aq\e0\(aq) (побочный эффект: \fI*ps\fP возвращается в начальное состояние). В этом случае \fI*src\fP устанавливается равным NULL и возвращается количество широких символов, записанных в \fIdest\fP, не считая завершающего широкого символа null. .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 lbw28 l l l. Интерфейс Атрибут Значение T{ \fBmbsrtowcs\fP() T} Безвредность в нитях MT\-Unsafe race:mbsrtowcs/!ps .TE .sp 1 .SH "СООТВЕТСТВИЕ СТАНДАРТАМ" POSIX.1\-2001, POSIX.1\-2008, 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) .SH ЗАМЕЧАНИЯ Эта страница является частью проекта Linux \fIman\-pages\fP версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу \%https://www.kernel.org/doc/man\-pages/. .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 .