mbrtowc

ヘッダー `<wchar.h>` で定義
size_t mbrtowc( wchar_t* pwc, const char* s, size_t n, mbstate_t* ps );		(C95 以降)
size_t mbrtowc( wchar_t restrict pwc, const char restrict s, size_t n, mbstate_t *restrict ps );		(C99以降)

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

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

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

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

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

s から変換された文字（非ヌルの場合は pwc に格納）がヌル文字だった場合は 0
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 ]

[編集] 参考文献

C11標準 (ISO/IEC 9899:2011)

7.29.6.3.2 The mbrtowc function (p: 443)

C99標準 (ISO/IEC 9899:1999)

7.24.6.3.2 The mbrtowc function (p: 389)

[編集] 関連項目

mbtowc	次のマルチバイト文字をワイド文字に変換する (関数) [編集]
wcrtombwcrtomb_s (C95)(C11)	与えられた状態で、ワイド文字をそのマルチバイト表現に変換する (関数) [編集]
C++ ドキュメント mbrtowc

コンパイラサポート
言語
ヘッダー
型サポート
プログラムユーティリティ
可変長引数関数のサポート
エラーハンドリング
動的メモリ管理
文字列ライブラリ
アルゴリズム
数値
日付と時刻のユーティリティ
入出力サポート
ローカライゼーションサポート
並行処理サポート (C11)
技術仕様
シンボルインデックス

pwc	-	生成されるワイド文字を書き込む場所へのポインタ
s	-	入力として使用されるマルチバイト文字列へのポインタ
n	-	検査できるs内のバイト数の制限
ps	-	マルチバイト文字文字列の解釈時に使用される変換状態へのポインタ

cppreference.com

名前空間

変種

表示

操作

mbrtowc

目次

[編集] パラメータ

[編集] 戻り値

[編集] 例

[編集] 参考文献

[編集] 関連項目

ナビゲーション

ツールボックス