mbsrtowcs, mbsrtowcs_s

size_t mbsrtowcs( wchar_t* dst, const char** src, size_t len, mbstate_t* ps );

size_t mbsrtowcs( wchar_t *restrict dst, const char **restrict src, size_t len,
                  mbstate_t *restrict ps );

errno_t mbsrtowcs_s( size_t *restrict retval,
                     wchar_t *restrict dst, rsize_t dstsz,
                     const char **restrict src, rsize_t len,
                     mbstate_t *restrict ps );

• Многобайтовый нулевой символ был преобразован и сохранён. *src устанавливается в значение указателя null, и *ps представляет собой начальное состояние сдвига.
• Встретился недопустимый многобайтовый символ (согласно текущему C-локали). *src устанавливается на начало первого не преобразованного многобайтового символа.
• следующий широких символ для сохранения превысил бы len. *src устанавливается на начало первого не преобразованного многобайтового символа. Это условие не проверяется, если dst является нулевым указателем.

• функция возвращает свой результат как параметр вывода retval
• если в dst после записи len широких символов не был записан нулевой символ, то L'\0' сохраняется в dst[len], что означает, что в целом записано len+1 широких символов
• функция очищает массив назначения от завершающего нуля и до dstsz
• Если src и dst перекрываются, поведение не определено.
• следующие ошибки обнаруживаются во время выполнения и вызывают текущую установленную функцию обработчика ограничений обработчика ограничений:

• retval, ps, src, или *src является нулевым указателем
• dstsz или len больше RSIZE_MAX/sizeof(wchar_t) (если dst не null)
• dstsz не равно нулю (если dst не null)
• В первых dstsz многобайтовых символах массива *src нет нулевого символа и len больше dstsz (если dst не null)

Как и во всех функциях с проверкой границ, mbsrtowcs_s гарантированно доступен только если __STDC_LIB_EXT1__ определено реализацией и если пользователь определяет __STDC_WANT_LIB_EXT1__ как целочисленную константу 1 перед включением <wchar.h>.

Параметры

Возвращаемое значение

Пример

#include <stdio.h>
#include <locale.h>
#include <wchar.h>
#include <string.h>
 
void print_as_wide(const char* mbstr)
{
    mbstate_t state;
    memset(&state, 0, sizeof state);
    size_t len = 1 + mbsrtowcs(NULL, &mbstr, 0, &state);
    wchar_t wstr[len];
    mbsrtowcs(&wstr[0], &mbstr, len, &state);
    wprintf(L"Wide string: %ls \n", wstr);
    wprintf(L"The length, including L'\\0': %zu\n", len);
}
 
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    print_as_wide(u8"z\u00df\u6c34\U0001f34c"); // u8"zß水🍌"
}

Wide string: zß水🍌
The length, including L'\0': 5

Ссылки

• Стандарт C11 (ISO/IEC 9899:2011):
• 7.29.6.4.1 Функция mbsrtowcs (с. 445)
• K.3.9.3.2.1 Функция mbsrtowcs_s (с. 648-649)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.24.6.4.1 Функция mbsrtowcs (с. 391)

См. также