std::mbsrtowcs

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

ヌル終端マルチバイト文字列

関数 ワイド/マルチバイト文字の検査 mblen mbrlen mbsinit マルチバイト/ワイド文字変換 mbtowc mbstowcs btowc mbrtowc mbsrtowcs    wctomb wcstombs wctob wcrtomb wcsrtombs mbrtoc8 (C++20) mbrtoc16 (C++11) mbrtoc32 (C++11) c8rtomb (C++20) c16rtomb (C++11) c32rtomb (C++11)

型

mbstate_t

マクロ

MB_LEN_MAX MB_CUR_MAX __STDC_UTF_16__ __STDC_UTF_32__ (C++11)(C++11)

 

ヘッダ <cwchar> で定義
std::size_t mbsrtowcs( wchar_t* dst,                        const char** src,                        std::size_t len,                        std::mbstate_t* ps );

指定された変換状態*psから始まる、NULL終端のマルチバイト文字シーケンスを、*srcが指す配列からワイド文字表現に変換します。 dstがNULLでない場合、変換された文字はdstが指すwchar_t配列の連続する要素に格納されます。宛先配列には、len個を超えるワイド文字は書き込まれません。

各マルチバイト文字は、std::mbrtowcを呼び出すかのように変換されます。変換は次の場合に停止します。

• マルチバイトNULL文字が変換および格納された。 srcはNULLポインタに設定され、*psは初期シフト状態を表します。
• 無効なマルチバイト文字（現在のCロケールに従って）が検出された。 srcは、変換されていない最初のマルチバイト文字の先頭を指すように設定されます。
• 次に格納されるワイド文字がlenを超える場合。 srcは、変換されていない最初のマルチバイト文字の先頭を指すように設定されます。 dstがNULLポインタの場合、この条件はチェックされません。

パラメータ

dst	-	結果が格納されるワイド文字配列へのポインタ
src	-	NULL終端のマルチバイト文字列の最初の要素へのポインタへのポインタ
len	-	dstが指す配列で利用可能なワイド文字数
ps	-	変換状態オブジェクトへのポインタ。

戻り値

成功した場合、終端のL'\0'を除いて、文字配列に書き込まれたワイド文字数を返します。 dstがNULLポインタの場合、無制限の長さで書き込まれたであろうワイド文字数を返します。

変換エラーの場合（無効なマルチバイト文字が検出された場合）、static_cast<std::size_t>(-1)を返し、EILSEQをerrnoに格納し、*psを未指定の状態のままにします。

注記

この関数は、変換されたマルチバイト文字列の末尾にsrcポインタを移動させます。 dstがNULLポインタの場合は、これは発生しません。

例

このコードを実行

#include <clocale>
#include <cwchar>
#include <iostream>
#include <vector>
 
void print_as_wide(const char* mbstr)
{
    std::mbstate_t state = std::mbstate_t();
    std::size_t len = 1 + std::mbsrtowcs(nullptr, &mbstr, 0, &state);
    std::vector<wchar_t> wstr(len);
    std::mbsrtowcs(&wstr[0], &mbstr, wstr.size(), &state);
    std::wcout << "Wide string: " << &wstr[0] << '\n'
               << "The length, including '\\0': " << wstr.size() << '\n';
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    const char* mbstr = "z\u00df\u6c34\U0001f34c"; // or u8"zß水🍌"
    print_as_wide(mbstr);
}

出力

Wide string: zß水🍌
The length, including '\0': 5

関連項目

mbrtowc	与えられた状態で、次のマルチバイト文字をワイド文字に変換する (関数)
wcsrtombs	与えられた状態で、ワイド文字列をナローマルチバイト文字列に変換する (関数)
do_in [virtual]	ファイルからの読み込み時など、ExternT から InternT への文字列を変換します。 (std::codecvt<InternT,ExternT,StateT> の virtual protected メンバ関数)
Cドキュメント mbsrtowcs