mbtowc

s が指す先頭バイトから始まるマルチバイト文字をワイド文字に変換し、 pwc が null でない場合、変換結果を * pwc に書き込む。

s がヌルポインタの場合、グローバル変換状態をリセットし、シフトシーケンスが使用されるかどうかを判定します。

注記

mbtowc の各呼び出しは、内部のグローバル変換状態（この関数のみが知る mbstate_t 型の静的オブジェクト）を更新します。マルチバイトエンコーディングがシフト状態を使用する場合、バックトラッキングや複数回のスキャンを避ける注意が必要です。いずれにせよ、複数のスレッドが同期なしに mbtowc を呼び出すべきではありません。代わりに mbrtowc が使用できます。

パラメータ

戻り値

s が null ポインタでない場合、マルチバイト文字に含まれるバイト数を返す。または - 1 を返す（ s が指す先頭バイト列が有効なマルチバイト文字を形成しない場合）。または ​ 0 ​ を返す（ s がナル文字 ' \0 ' を指している場合）。

s がヌルポインタの場合、内部変換状態を初期シフト状態にリセットし、現在のマルチバイトエンコーディングが状態依存でない場合（シフトシーケンスを使用しない）は ​ 0 ​ を返し、現在のマルチバイトエンコーディングが状態依存の場合（シフトシーケンスを使用する）は非ゼロの値を返します。

例

#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <wchar.h>
// print multibyte string to wide-oriented stdout
// equivalent to wprintf(L"%s\n", ptr);
void print_mb(const char* ptr)
{
    mbtowc(NULL, NULL, 0); // reset the conversion state
    const char* end = ptr + strlen(ptr);
    int ret = 0;
    for (wchar_t wc; (ret = mbtowc(&wc, ptr, end - ptr)) > 0; ptr += ret)
        wprintf(L"%lc", wc);
    wprintf(L"\n");
}
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    print_mb("z\u00df\u6c34\U0001F34C"); // or "zß水🍌"
}

zß水🍌

参考文献

関連項目