std::wcsrtombs

 

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 wcsrtombs( char* dst,                        const wchar_t** src,                        std::size_t len,                        std::mbstate_t* ps );

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

std::wcrtomb の呼び出しのように、各文字が変換されます。変換は、以下のいずれかの条件で停止します。

• ヌル文字が変換され、格納された場合。 src はヌルポインタに設定され、*ps は初期シフト状態を表します。
• 現在の C ロケールで有効な文字に対応しない wchar_t が見つかった場合。 src は、変換されなかった最初のワイド文字を指すように設定されます。
• 次に格納されるマルチバイト文字が len を超える場合。 src は、変換されなかった最初のワイド文字を指すように設定されます。 dst がヌルポインタである場合、この条件はチェックされません。

パラメータ

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

戻り値

成功した場合、 dst が指す文字配列に書き込まれたバイト数（シフトシーケンスを含むが、終端の '\0' を除く）を返します。 dst がヌルポインタの場合、書き込まれたであろうバイト数（こちらも終端のヌル文字 '\0' を除く）を返します。

変換エラーの場合（無効なワイド文字が検出された場合）、 static_cast<std::size_t>(-1) を返し、 *ps は未規定の状態になります。

例

このコードを実行

#include <clocale>
#include <cwchar>
#include <iostream>
#include <string>
#include <vector>
 
void print_wide(const wchar_t* wstr)
{
    std::mbstate_t state = std::mbstate_t();
    std::size_t len = 1 + std::wcsrtombs(nullptr, &wstr, 0, &state);
    std::vector<char> mbstr(len);
    std::wcsrtombs(&mbstr[0], &wstr, mbstr.size(), &state);
    std::cout << "multibyte string: " << &mbstr[0] << '\n'
              << "Length, including '\\0': " << mbstr.size() << '\n';
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const wchar_t* wstr = L"z\u00df\u6c34\U0001d10b"; // or L"zß水𝄋"
    print_wide(wstr);
}

出力

multibyte string: zß水𝄋
Length, including '\0': 11

関連項目

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