mbsnrtowcs(3)

НАИМЕНОВАНИЕ
mbsnrtowcs - преобразует многобайтовую строку в строку широких символов

БИБЛИОТЕКА
Стандартная библиотека языка C (libc, -lc)

ОБЗОР
#include <wchar.h>

size_t mbsnrtowcs(size_t size;
                  wchar_t dest[restrict size], const char **restrict src,
                  size_t nms, size_t size, mbstate_t *restrict ps);

    Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

mbsnrtowcs():
    Начиная с glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    До glibc 2.10:
        _BSD_SOURCE

ОПИСАНИЕ
Функция mbsnrtowcs() похожа на функцию mbsrtowcs(3), исключая то, что количество преобразуемых байт, начиная с *src, ограничено nms байтами.

If dest is not NULL, the mbsnrtowcs() function converts at most nms bytes from the multibyte string *src to a wide-character string starting at dest. At most size wide characters are written to dest. The shift state *ps is updated. The conversion is effectively performed by repeatedly calling mbrtowc(dest, *src, n, ps) where n is some positive number, as long as this call succeeds, and then incrementing dest by one and *src by the number of bytes consumed. The conversion can stop for three reasons:

•   Во входных данных обнаружена неправильная многобайтовая последовательность. В этом случае *src по-прежнему указывает на неправильную многобайтовую последовательность, возвращается (size_t) -1 и errno присваивается EILSEQ.

•   The nms limit forces a stop, or size non-L'\0' wide characters have been stored at dest. In this case, *src is left pointing to the next multibyte sequence to be converted, and the number of wide characters written to dest is returned.

•   The multibyte string has been completely converted, including the terminating null wide character ('\0') (which has the side effect of bringing back *ps to the initial state). In this case, *src is set to NULL, and the number of wide characters written to dest, excluding the terminating null wide character, is returned.

Если входной буфер заканчивается неполным символом, в POSIX.1 не указано где остановится преобразование — в конце предыдущего символа (если есть) или в конце входного буфера. В реализации glibc принят первый вариант.

If dest is NULL, size 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.

В обоих перечисленных случаях, если ps равно NULL, то используется статическое анонимное состояние, известное только функции mbsnrtowcs().

The programmer must ensure that there is room for at least size wide characters at dest.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Функция mbsnrtowcs() возвращает количество широких символов, которые составили преобразованную часть широкосимвольной строки, не включая конечный широкий символ null. Если обнаружена некорректная многобайтовая последовательность, то возвращается (size_t) -1, а errno присваивается EILSEQ.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
mbsnrtowcs() | Безвредность в нитях | MT-Unsafe race:mbsnrtowcs/!ps

СТАНДАРТЫ
POSIX.1-2008.

ПРИМЕЧАНИЯ
Поведение mbsnrtowcs() зависит от категории LC_CTYPE текущей локали.

Передавать NULL в качестве ps небезопасно при работе с нитями.

СМОТРИТЕ ТАКЖЕ
iconv(3), mbrtowc(3), mbsinit(3), mbsrtowcs(3)

ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и) aereiae <aereiae@gmail.com>, Alexey <a.chepugov@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, ITriskTI <ITriskTI@gmail.com>, Max Is <ismax799@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Малянов Евгений Викторович <maljanow@outlook.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков (<debian-l10n-russian@lists.debian.org>).