std::mbstowcs

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

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

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

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

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

 

ヘッダ <cstdlib> で定義
std::size_t mbstowcs(wchar_t* dst, constchar* src, std::size_t len);

src によって最初の要素が指されている配列のマルチバイト文字列をワイド文字表現に変換します。 変換後の文字は dst の指す配列の連続する要素に格納されます。 最大 len 個のワイド文字が格納先の配列に書き込まれます。

各文字は mbtowc の変換状態が影響を受けないことを除いて std::mbtowc を呼んだかのように変換されます。 変換は以下の場合に停止します。

• マルチバイトヌル文字が変換され格納された。
• (現在の C のロケールにおいて) 無効なマルチバイト文字に遭遇した。
• 格納する次のワイド文字が len を超える。

ノート

ほとんどの処理系では、この関数は文字列を処理するにあたって std::mbstate_t 型のグローバルな静的オブジェクトを更新し、複数のスレッドから同時に呼ぶことができません。 そのような場合は std::mbsrtowcs を使用するべきです。

POSIX は次のようなよくある拡張を規定しています。 dst がヌルポインタの場合、この関数は、もし変換が行われたならば dst に書き込まれたであろうワイド文字数を返します。 同様の動作は std::mbsrtowcs の場合は標準です。

引数

dst	-	ワイト文字列が格納されるワイド文字配列を指すポインタ
src	-	変換するヌル終端マルチバイト文字列の最初の要素を指すポインタ
len	-	dst の指す配列の利用可能なワイド文字数

戻り値

成功した場合は、格納先の配列に書き込まれた、終端の L'\0' を除くワイド文字数を返します。

変換エラーが発生した (無効なマルチバイト文字に遭遇した) 場合は、 static_cast<std::size_t>(-1) を返します。

例

Run this code

#include <iostream>#include <clocale>#include <cstdlib>int main(){std::setlocale(LC_ALL, "en_US.utf8");std::wcout.imbue(std::locale("en_US.utf8"));constchar* mbstr = u8"z\u00df\u6c34\U0001f34c";// or u8"zß水🍌"// or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c";wchar_t wstr[5]; std::mbstowcs(wstr, mbstr, 5);std::wcout<<"wide string: "<< wstr <<'\n';}

出力:

wide string: zß水🍌

関連項目

mbsrtowcs	指定された状態を使用してマルチバイト文字列をワイド文字列に変換します (関数)
wcstombs	ワイド文字列をマルチバイト文字列に変換します (関数)
do_in [仮想]	ファイルから読み込む時などのために、文字列を externT から internT に変換します (std::codecvt<InternT,ExternT,State>の仮想プロテクテッドメンバ関数)
mbstowcs の C言語リファレンス