std::wcstombs

 

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 wcstombs(char* dst, constwchar_t* src, std::size_t len);

src によって最初の要素が指されている配列のワイド文字シーケンスを初期シフト状態で始まるナローマルチバイト表現に変換します。 変換された文字は dst の指す文字配列の連続する要素に格納されます。 最大 len バイトが格納先の配列に書き込まれます。

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

• ヌル文字が変換され格納された。
• 現在の C のロケールにおいて有効な文字に対応しない wchar_t が見つかった。
• 格納される次のマルチバイト文字が len を超える。

ノート

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

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

引数

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

戻り値

成功した場合は、 dst によって最初の要素が指されている文字配列に書き込まれた (シフトシーケンスを含み、終端の '\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");// UTF-8 narrow multibyte encodingconstwchar_t* wstr = L"z\u00df\u6c34\U0001d10b";// or L"zß水𝄋"char mbstr[11]; std::wcstombs(mbstr, wstr, 11);std::cout<<"multibyte string: "<< mbstr <<'\n';}

出力:

multibyte string: zß水𝄋

関連項目

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