std:: mbrtoc16

ナローマルチバイト文字をUTF-16文字表現に変換します。

s が null ポインタでない場合、最大 n バイトのマルチバイト文字列を検査し、 s が指すバイトから始めて、次のマルチバイト文字を完了するために必要なバイト数（シフトシーケンスを含む）を決定します。関数が s 内の次のマルチバイト文字が完全かつ有効であると判断した場合、それを対応する16ビット文字に変換し、 * pc16 に格納します（ pc16 が null でない場合）。

マルチバイト文字が * s 内に存在し、それが複数の char16_t シーケンス（例：UTF-16におけるサロゲートペア）に対応する場合、この関数の最初の呼び出し後、 * ps は更新され、次回の mbrtoc16 呼び出しで追加の char16_t を出力するようになります。この際、 * s は考慮されません。

s がヌルポインタの場合、 n および pc16 の値は無視され、この呼び出しは std :: mbrtoc16 ( nullptr, "" , 1 , ps ) と等価になります。

生成されたワイド文字がナル文字である場合、変換状態 * ps は初期シフト状態を表します。

この関数で使用されるマルチバイトエンコーディングは、現在アクティブなCロケールによって指定されます。

パラメータ

戻り値

以下のうち最初に該当するもの：

• ​ 0 ​ sから変換された文字（かつnullでない場合 * pc16 に格納される）がナル文字であった場合。
• 正常に変換されたマルチバイト文字のバイト数 [ 1 , n ] （sから変換）。
• - 3 マルチ char16_t 文字（例：サロゲートペア）の次の char16_t が * pc16 に書き込まれた場合。この場合、入力からはバイトが処理されない。
• - 2 次の n バイトが不完全ではあるが、現時点で有効なマルチバイト文字を構成する場合。 * pc16 には何も書き込まれない。
• - 1 エンコーディングエラーが発生した場合。 * pc16 には何も書き込まれず、値 EILSEQ が errno に格納され、 * ps の値は未規定となる。

例

#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

関連項目