std::codecvt_utf8_utf16
ヘッダ <codecvt> で定義
|
||
template< class Elem, unsigned long Maxcode = 0x10ffff, |
(C++11以上) (C++17で非推奨) |
|
std::codecvt_utf8_utf16 は UTF-8 エンコードされたバイト文字列と UTF-16 エンコードされた文字列の間の変換をカプセル化する std::codecvt ファセットです。 Elem
が32ビット型の場合、ひとつの UTF-16 コード単位が出力シーケンスの各32ビット文字に格納されます。
これは N:M 変換ファセットであり、 std::basic_filebuf で使用することはできません ( std::basic_filebuf では UTF-32/UTF-8 などの内部エンコーディングと外部エンコーディングの間で 1:N の変換のみが許容されます)。 このファセットは std::wstring_convert で使用することができます。
目次 |
[編集] テンプレート引数
Elem | - | char16_t、 char32_t または wchar_t のいずれか |
Maxcode | - | このファセットがエラーなしに読み書きする Elem の最も大きな値
|
Mode | - | std::codecvt_mode 型の定数 |
[編集] メンバ関数
コンストラクタ |
新しい codecvt_utf8_utf16 ファセットを構築します (パブリックメンバ関数) |
デストラクタ |
codecvt_utf8_utf16 ファセットを破棄します (パブリックメンバ関数) |
std::codecvt_utf8_utf16::codecvt_utf8_utf16
explicit codecvt_utf8_utf16( std::size_t refs = 0 ); |
||
新しい std::codecvt_utf8_utf16
ファセットを構築し、初期参照カウンタ refs
を基底クラスに渡します。
引数
refs | - | ファセットにリンクする参照の数 |
std::codecvt_utf8_utf16::~codecvt_utf8_utf16
~codecvt_utf8_utf16(); |
||
ファセットを破棄します。 ロケール管理のファセットと異なり、このファセットのデストラクタはパブリックです。
std::codecvt から継承
メンバ型
メンバ型 | 定義 |
intern_type
|
internT
|
extern_type
|
externT
|
state_type
|
stateT
|
メンバオブジェクト
メンバ名 | 型 |
id (static)
|
std::locale::id |
メンバ関数
do_out を呼びます ( std::codecvt のパブリックメンバ関数)
| |
do_in を呼びます ( std::codecvt のパブリックメンバ関数)
| |
do_unshift を呼びます ( std::codecvt のパブリックメンバ関数)
| |
do_encoding を呼びます ( std::codecvt のパブリックメンバ関数)
| |
do_always_noconv を呼びます ( std::codecvt のパブリックメンバ関数)
| |
do_length を呼びます ( std::codecvt のパブリックメンバ関数)
| |
do_max_length を呼びます ( std::codecvt のパブリックメンバ関数)
|
プロテクテッドメンバ関数
[仮想] |
ファイルを書き込む時などのために、文字列を internT から externT に変換します ( std::codecvt の仮想プロテクテッドメンバ関数)
|
[仮想] |
ファイルから読み込む時などのために、文字列を externT から internT に変換します ( std::codecvt の仮想プロテクテッドメンバ関数)
|
[仮想] |
不完全な変換に対する externT 文字の終了文字シーケンスを生成します ( std::codecvt の仮想プロテクテッドメンバ関数)
|
[仮想] |
一定であれば、ひとつの internT 文字を生成するのに必要な externT の文字数を返します ( std::codecvt の仮想プロテクテッドメンバ関数)
|
[仮想] |
ファセットがすべての有効な引数の値に対して恒等変換をエンコードするかどうか調べます ( std::codecvt の仮想プロテクテッドメンバ関数)
|
[仮想] |
与えられた internT バッファへの変換によって消費されるであろう externT 文字列の長さを計算します ( std::codecvt の仮想プロテクテッドメンバ関数)
|
[仮想] |
単一の internT 文字に変換される可能性のある externT の最大文字数を返します ( std::codecvt の仮想プロテクテッドメンバ関数)
|
std::codecvt_base から継承
メンバ型 | 定義 |
enum result { ok, partial, error, noconv }; | スコープなし列挙型 |
列挙定数 | 定義 |
ok
|
変換はエラーなしで完了しました |
partial
|
変換元の文字は全部は変換されませんでした |
error
|
無効な文字に遭遇しました |
noconv
|
変換は必要ありません、入力と出力の型は同じです |
[編集] 例
#include <iostream> #include <string> #include <codecvt> #include <cassert> #include <locale> int main() { std::string u8 = u8"z\u00df\u6c34\U0001f34c"; std::u16string u16 = u"z\u00df\u6c34\U0001f34c"; // UTF-8 to UTF-16/char16_t std::u16string u16_conv = std::wstring_convert< std::codecvt_utf8_utf16<char16_t>, char16_t>{}.from_bytes(u8); assert(u16 == u16_conv); std::cout << "UTF-8 to UTF-16 conversion produced " << u16_conv.size() << " code units:\n"; for (char16_t c : u16_conv) std::cout << std::hex << std::showbase << c << ' '; // UTF-16/char16_t to UTF-8 std::string u8_conv = std::wstring_convert< std::codecvt_utf8_utf16<char16_t>, char16_t>{}.to_bytes(u16); assert(u8 == u8_conv); std::cout << "\nUTF-16 to UTF-8 conversion produced " << std::dec << u8_conv.size() << " bytes:\n" << std::hex; for (char c : u8_conv) std::cout << +(unsigned char)c << ' '; }
出力:
UTF-8 to UTF-16 conversion produced 5 code units: 0x7a 0xdf 0x6c34 0xd83c 0xdf4c UTF-16 to UTF-8 conversion produced 10 bytes: 0x7a 0xc3 0x9f 0xe6 0xb0 0xb4 0xf0 0x9f 0x8d 0x8c
[編集] 関連項目
文字変換 | ロケール定義のマルチバイト (UTF-8, GB18030) |
UTF-8 |
UTF-16 |
---|---|---|---|
UTF-16 | mbrtoc16 / c16rtomb(C11のDR488あり) | codecvt<char16_t, char, mbstate_t> codecvt_utf8_utf16<char16_t> codecvt_utf8_utf16<char32_t> codecvt_utf8_utf16<wchar_t> |
N/A |
UCS2 | c16rtomb(C11のDR488なし) | codecvt_utf8<char16_t> codecvt_utf8<wchar_t>(Windows) |
codecvt_utf16<char16_t> codecvt_utf16<wchar_t>(Windows) |
UTF-32 |
codecvt<char32_t, char, mbstate_t> |
codecvt_utf16<char32_t> | |
システム全体: UTF-32(Windows以外) UCS2(Windows) |
mbsrtowcs / wcsrtombs |
No | No |
UTF-8, UTF-16, UTF-32 を含む文字エンコーディング間の変換を行います (クラステンプレート) | |
(C++11)(C++17で非推奨) |
標準の codecvt ファセットの動作を変更するためのタグ (列挙) |
(C++11)(C++17で非推奨) |
UTF-8 と UCS2/UCS4 の間で変換を行います (クラステンプレート) |
(C++11)(C++17で非推奨) |
UTF-16 と UCS2/UCS4 の間で変換を行います (クラステンプレート) |