std::c32rtomb

 

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

 

ヘッダ <cuchar> で定義
std::size_t c32rtomb(char* s, char32_t c32, std::mbstate_t* ps );		(C++11以上)

UTF-32 文字をナローマルチバイト表現に変換します。

s がヌルポインタでなければ、 c32 のマルチバイト文字表現 (あらゆるシフトシーケンスを含み、現在のマルチバイト変換状態 *ps を考慮に入れた) を格納するために必要なバイト数を決定し、 s によって最初の要素が指されている文字配列にそのマルチバイト表現を格納し、必要に応じて *ps を更新します。 最大 MB_CUR_MAX バイトが書き込まれます。

s がヌルポインタであれば、その呼び出しは何らかの内部バッファ buf に対する std::c32rtomb(buf, U'\0', ps) と同等です。

c32 がヌルワイド文字 u'\0' であれば、初期シフト状態を復元するために必要なあらゆるシフトシーケンスの後にヌルのバイトが格納され、 *ps が初期シフト状態を表すように更新されます。

この関数が使用するマルチバイト文字エンコーディングは、現在アクティブな C のロケールによって指定されます。

引数

s	-	マルチバイト文字が格納されるナロー文字配列を指すポインタ
c32	-	変換する32ビット文字
ps	-	マルチバイト文字を解釈するときに使用される変換状態オブジェクトを指すポインタ

戻り値

成功した場合は、 s によって最初の要素が指されている文字配列に書き込まれた (あらゆるシフトシーケンスを含む) バイト数を返します。 この値は、例えば複数の char32_t の文字のシーケンスの先行する char32_t を処理するとき (UTF-32 では発生しません) など、 ​0​ になる場合があります。

失敗した場合 (c32 が有効な32ビット文字でない場合) は、 -1 を返し、 EILSEQ を errno に格納し、 *ps を未規定な状態に置きます。

例

Run this code

#include <iostream>#include <iomanip>#include <string_view>#include <clocale>#include <cuchar>#include <climits>   int main(){std::setlocale(LC_ALL, "en_US.utf8");std::u32string_view strv = U"zß水🍌";// or z\u00df\u6c34\U0001F34Cstd::cout<<"Processing "<< strv.size()<<" UTF-32 code units: [ ";for(char32_t c : strv)std::cout<<std::showbase<<std::hex<< c <<' ';std::cout<<"]\n";   std::mbstate_t state{};char out[MB_LEN_MAX]{};for(char32_t c : strv){std::size_t rc = std::c32rtomb(out, c, &state);std::cout<< c <<" converted to [ ";if(rc !=(std::size_t)-1)for(unsignedchar c8 :std::string_view{out, rc})std::cout<<+c8 <<' ';std::cout<<"]\n";}}

出力:

Processing 4 UTF-32 code units: [ 0x7a 0xdf 0x6c34 0x1f34c ] 0x7a converted to [ 0x7a ] 0xdf converted to [ 0xc3 0x9f ] 0x6c34 converted to [ 0xe6 0xb0 0xb4 ] 0x1f34c converted to [ 0xf0 0x9f 0x8d 0x8c ]

関連項目

mbrtoc32 (C++11)	ナローマルチバイト文字を UTF-32 エンコーディングに変換します (関数)
do_out [仮想]	ファイルを書き込む時などのために、文字列を internT から externT に変換します (std::codecvt<InternT,ExternT,State>の仮想プロテクテッドメンバ関数)
c32rtomb の C言語リファレンス