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);

Notes

Dans la plupart des implémentations, mbstowcs met à jour un objet statique global de type mbstate_t en parcourant la chaîne, et ne peut pas être appelée simultanément par deux threads ; mbsrtowcs devrait être utilisée dans de tels cas.

POSIX spécifie une extension courante : si dst est un pointeur nul, cette fonction retourne le nombre de caractères larges qui seraient écrits dans dst, si convertis. Un comportement similaire est standard pour mbstowcs_s et pour mbsrtowcs.

Paramètres

Valeur de retour

Exemple

#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ß水🍌

Références

Voir aussi