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 ]

参考文献