C/C++のc16rtomb()関数とは？16ビット文字をマルチバイト文字へ変換する方法

C++では、char16_t型による16ビット文字表現（UTF-16エンコード）を扱うことができます。c16rtomb()関数は、このような16ビット文字表現を、システムが使用するナローマルチバイト文字表現へ変換するための関数です。この関数はuchar.hヘッダーファイル内で定義されています。

c16rtomb()関数の基本情報

c16rtomb()関数は、次の3つの引数を受け取ります。

• 出力先のバッファ： 変換後のマルチバイト文字を格納する文字配列
• 変換対象の文字： char16_t型の16ビット文字
• 変換状態オブジェクト： マルチバイト文字列の解釈状態を管理するmbstate_t型オブジェクトへのポインタ

戻り値

変換が成功した場合は、文字配列に書き込まれたバイト数が返されます。一方、変換に失敗した場合は-1が返されます。また、引数にヌル文字を渡して初期化モードとして呼び出すことで、変換状態をリセットすることも可能です。

サンプルコード

それでは、実際のコード例を見てみましょう。

#include <iostream>
#include <uchar.h>
#include <wchar.h>
using namespace std;
int main() {
    const char16_t myStr[] = u"Hello World";
    char dest[50];
    mbstate_t p{};
    size_t length;
    int j = 0;
    while (myStr[j]) {
        length = c16rtomb(dest, myStr[j], &p); //c16rtomb()から書き込みバイト数を取得
        if ((length == 0) || (length > 50))
            break;
        for (int i = 0; i < length; ++i)
            cout << dest[i];
        j++;
    }
}

実行結果

Hello World

このコードでは、u"Hello World"というUTF-16形式の文字列リテラルを1文字ずつ取り出し、c16rtomb()を使ってマルチバイト文字に変換しています。返されたバイト数分だけdest配列から標準出力へ書き出すことで、元の文字列「Hello World」が出力されます。

このように、c16rtomb()関数を活用すれば、UTF-16ベースの文字データを環境依存のマルチバイト文字コードへ安全に変換でき、国際化対応のプログラム開発において非常に役立ちます。