mbstowcs, mbstowcs_s

size_t mbstowcs( wchar_t* dst, const char* src, size_t len)

size_t mbstowcs( wchar_t* restrict dst, const char* restrict src, size_t len)

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

Замечания

В большинстве реализаций mbstowcs обновляет глобальный статический объект типа mbstate_t по мере обработки строки, и не может вызываться одновременно двумя потоками; в таких случаях следует использовать mbsrtowcs.

POSIX определяет распространённое расширение: если dst является нулевым указателем, эта функция возвращает количество широких символов, которые были бы записаны в dst при преобразовании. Аналогичное поведение является стандартным для mbstowcs_s и для mbsrtowcs.

Параметры

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

Пример

#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>

int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    const char* mbstr = u8"z\u00df\u6c34\U0001F34C"; // or u8"zß水🍌"
    wchar_t wstr[5];
    mbstowcs(wstr, mbstr, 5);
    wprintf(L"MB string: %s\n", mbstr);
    wprintf(L"Wide string: %ls\n", wstr);
}

MB string: zß水🍌
Wide string: zß水🍌

Ссылки

Смотрите также