mbrtowc

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

sがnullポインタでない場合、マルチバイト文字列のうちsが指すバイトから始まる最大nバイトを検査し、次のマルチバイト文字を完了するために必要なバイト数（シフトシーケンスを含み、現在のマルチバイト変換状態*psを考慮して）を決定します。関数がsの次のマルチバイト文字が完全かつ有効であると判断した場合、それを対応するワイド文字に変換し（pwcがnullでない場合）*pwcに格納します。

s がヌルポインタの場合、 n と pwc の値は無視され、この呼び出しは mbrtowc ( NULL , "" , 1 , ps ) と等価です。

生成されたワイド文字がナル文字である場合、 * ps に格納された変換状態は初期シフト状態となります。

環境マクロ __STDC_ISO_10646__ が定義されている場合、 wchar_t 型の値はUnicode必須セットの文字の短い識別子（通常はUTF-32エンコーディング）と同じです。定義されていない場合、これは実装定義です。いずれの場合も、この関数で使用されるマルチバイト文字エンコーディングは、現在アクティブなCロケールによって指定されます。

パラメータ

戻り値

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

• ​ 0 ​ sから変換された文字（かつ非NULLの場合pwcに格納された）がナル文字であった場合
• sから正常に変換されたマルチバイト文字のバイト数 [ 1 ... n ]
• ( size_t ) - 2 次のnバイトが不完全ではあるが、現時点では有効なマルチバイト文字を構成する場合。*pwcには何も書き込まれない。
• ( size_t ) - 1 エンコーディングエラーが発生した場合。*pwcには何も書き込まれず、値 EILSEQ が errno に格納され、 * ps の値は未規定となる。

例

#include <stdio.h>
#include <locale.h>
#include <string.h>
#include <wchar.h>
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    mbstate_t state;
    memset(&state, 0, sizeof state);
    char in[] = u8"z\u00df\u6c34\U0001F34C"; // or u8"zß水🍌"
    size_t in_sz = sizeof in / sizeof *in;
    printf("Processing %zu UTF-8 code units: [ ", in_sz);
    for(size_t n = 0; n < in_sz; ++n) printf("%#x ", (unsigned char)in[n]);
    puts("]");
    wchar_t out[in_sz];
    char *p_in = in, *end = in + in_sz;
    wchar_t *p_out = out;
    int rc;
    while((rc = mbrtowc(p_out, p_in, end - p_in, &state)) > 0)
    {
        p_in += rc;
        p_out += 1;
    }
    size_t out_sz = p_out - out + 1;
    printf("into %zu wchar_t units: [ ", out_sz);
    for(size_t x = 0; x < out_sz; ++x) printf("%#x ", out[x]);
    puts("]");
}

Processing 11 UTF-8 code units: [ 0x7a 0xc3 0x9f 0xe6 0xb0 0xb4 0xf0 0x9f 0x8d 0x8c 0 ]
into 5 wchar_t units: [ 0x7a 0xdf 0x6c34 0x1f34c 0 ]

参考文献