std:: mbstowcs

Convertit une chaîne de caractères multioctets du tableau dont le premier élément est pointé par src en sa représentation en caractères larges. Les caractères convertis sont stockés dans les éléments successifs du tableau pointé par dst . Pas plus de len caractères larges sont écrits dans le tableau de destination.

Chaque caractère est converti comme par un appel à std::mbtowc , sauf que l'état de conversion mbtowc n'est pas affecté. La conversion s'arrête si :

• Le caractère nul multioctet a été converti et stocké.
• Un caractère multioctet invalide (dans les paramètres régionaux C actuels) a été rencontré.
• Le prochain caractère large à stocker dépasserait len .

Notes

Dans la plupart des implémentations, cette fonction met à jour un objet statique global de type std::mbstate_t pendant qu'elle traite la chaîne, et ne peut pas être appelée simultanément par deux threads, std::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 , s'ils étaient convertis. Un comportement similaire est standard pour std::mbsrtowcs .

Paramètres

Valeur de retour

En cas de succès, retourne le nombre de caractères larges, à l'exclusion du caractère de fin L ' \0 ' , écrits dans le tableau de destination.

En cas d'erreur de conversion (si un caractère multioctet non valide a été rencontré), retourne static_cast < std:: size_t > ( - 1 ) .

Exemple

#include <clocale>
#include <cstdlib>
#include <iostream>
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    const char* mbstr = "z\u00df\u6c34\U0001f34c"; // or u8"zß水🍌"
                        // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c";
    wchar_t wstr[5];
    std::mbstowcs(wstr, mbstr, 5);
    std::wcout << "wide string: " << wstr << '\n';
}

wide string: zß水🍌

Voir aussi