std:: mbrtoc16

Convertit un caractère multioctet étroit en représentation de caractère UTF-16.

Si s n'est pas un pointeur nul, inspecte au plus n octets de la chaîne de caractères multioctets, en commençant par l'octet pointé par s pour déterminer le nombre d'octets nécessaires pour compléter le prochain caractère multioctet (y compris toute séquence de changement). Si la fonction détermine que le prochain caractère multioctet dans s est complet et valide, le convertit en caractère 16 bits correspondant et le stocke dans * pc16 (si pc16 n'est pas nul).

Si le caractère multioctet dans * s correspond à une séquence multi- char16_t (par exemple, une paire de substitution en UTF-16), alors après le premier appel à cette fonction, * ps est mis à jour de telle sorte que le prochain appel à mbrtoc16 écrira le char16_t supplémentaire, sans considérer * s .

Si s est un pointeur nul, les valeurs de n et pc16 sont ignorées et l'appel est équivalent à std :: mbrtoc16 ( nullptr, "" , 1 , ps ) .

Si le caractère large produit est le caractère nul, l'état de conversion * ps représente l'état de décalage initial.

L'encodage multioctet utilisé par cette fonction est spécifié par la locale C actuellement active.

Paramètres

Valeur de retour

Le premier des éléments suivants qui s'applique :

• ​ 0 ​ si le caractère converti à partir de s (et stocké dans * pc16 s'il n'est pas nul) était le caractère nul.
• le nombre d'octets [ 1 , n ] du caractère multi-octets converti avec succès à partir de s .
• - 3 si le prochain char16_t d'un caractère multi- char16_t (par exemple, une paire de substitution) a maintenant été écrit dans * pc16 . Aucun octet n'est traité en entrée dans ce cas.
• - 2 si les prochains n octets constituent un caractère multi-octets incomplet mais jusqu'ici valide. Rien n'est écrit dans * pc16 .
• - 1 si une erreur d'encodage se produit. Rien n'est écrit dans * pc16 , la valeur EILSEQ est stockée dans errno et la valeur de * ps n'est pas spécifiée.

Exemple

#include <clocale>
#include <cstring>
#include <cuchar>
#include <cwchar>
#include <iomanip>
#include <iostream>
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::string str{"z\u00df\u6c34\U0001F34C"}; // or u8"zß水🍌"
    std::cout << "Processing " << str.size() << " bytes: [" << std::uppercase
              << std::setfill('0') << std::hex;
    for (int n{}; unsigned char c : str)
        std::cout << (n++ ? " " : "") << +c;
    std::cout << "]\n";
    std::mbstate_t state{}; // zero-initialized to initial state
    char16_t c16{};
    const char* ptr{&str[0]}, *end{&str[0] + str.size()};
    while (std::size_t rc{std::mbrtoc16(&c16, ptr, end - ptr + 1, &state)})
    {
        std::cout << "Next UTF-16 char: " << std::setw(4)
                  << static_cast<unsigned short>(c16) << " obtained from ";
        if (rc == std::size_t(-3))
            std::cout << "earlier surrogate pair\n";
        else if (rc == std::size_t(-2))
            continue;
        else if (rc == std::size_t(-1))
            break;
        else
        {
            std::cout << std::dec << rc << " bytes [";
            for (std::size_t n{}; n != rc; ++n)
                std::cout << (n ? " " : "") << std::hex
                          << +static_cast<unsigned char>(ptr[n]);
            std::cout << "]\n";
            ptr += rc;
        }
    }
}

Processing 10 bytes: [7A C3 9F E6 B0 B4 F0 9F 8D 8C]
Next UTF-16 char: 007A obtained from 1 bytes [7A]
Next UTF-16 char: 00DF obtained from 2 bytes [C3 9F]
Next UTF-16 char: 6C34 obtained from 3 bytes [E6 B0 B4]
Next UTF-16 char: D83C obtained from 4 bytes [F0 9F 8D 8C]
Next UTF-16 char: DF4C obtained from earlier surrogate pair

Voir aussi