std::codecvt_utf8_utf16

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

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

アルゴリズムライブラリ

数値演算ライブラリ

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

入出力ライブラリ

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

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

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

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

技術仕様書

 

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

ロケールとファセット
locale
use_facet	has_facet
文字分類
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
変換
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
ファセットカテゴリの基底クラス
ctype_base codecvt_base messages_base	time_base money_base
ファセットカテゴリ
ctype ctype<char> codecvt collate messages time_get time_put	num_get num_put numpunct money_get money_put moneypunct
ロケール固有のファセット
ctype_byname codecvt_byname messages_byname collate_byname	time_get_byname time_put_byname numpunct_byname moneypunct_byname
コード変換ファセット
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
Cのロケール
setlocale localeconv lconv	LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME

 

<tbody> </tbody>

ヘッダ <codecvt> で定義
template< class Elem, unsigned long Maxcode = 0x10ffff, std::codecvt_mode Mode = (std::codecvt_mode)0 > class codecvt_utf8_utf16 : public std::codecvt<Elem, char, std::mbstate_t>;		(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

<tbody> </tbody>

explicit codecvt_utf8_utf16( std::size_t refs = 0 );

新しい std::codecvt_utf8_utf16 ファセットを構築し、初期参照カウンタ refs を基底クラスに渡します。

引数

refs

-

ファセットにリンクする参照の数

std::codecvt_utf8_utf16::~codecvt_utf8_utf16

<tbody> </tbody>

~codecvt_utf8_utf16();

ファセットを破棄します。 ロケール管理のファセットと異なり、このファセットのデストラクタはパブリックです。

std::codecvt から継承

メンバ型

メンバ型	定義
intern_type	internT
extern_type	externT
state_type	stateT

メンバオブジェクト

メンバ名	型
id (static)	std::locale::id

メンバ関数

out	do_out を呼びます (std::codecvt<InternT,ExternT,State>のパブリックメンバ関数)
in	do_in を呼びます (std::codecvt<InternT,ExternT,State>のパブリックメンバ関数)
unshift	do_unshift を呼びます (std::codecvt<InternT,ExternT,State>のパブリックメンバ関数)
encoding	do_encoding を呼びます (std::codecvt<InternT,ExternT,State>のパブリックメンバ関数)
always_noconv	do_always_noconv を呼びます (std::codecvt<InternT,ExternT,State>のパブリックメンバ関数)
length	do_length を呼びます (std::codecvt<InternT,ExternT,State>のパブリックメンバ関数)
max_length	do_max_length を呼びます (std::codecvt<InternT,ExternT,State>のパブリックメンバ関数)

プロテクテッドメンバ関数

do_out [仮想]	ファイルを書き込む時などのために、文字列を internT から externT に変換します (std::codecvt<InternT,ExternT,State>の仮想プロテクテッドメンバ関数)
do_in [仮想]	ファイルから読み込む時などのために、文字列を externT から internT に変換します (std::codecvt<InternT,ExternT,State>の仮想プロテクテッドメンバ関数)
do_unshift [仮想]	不完全な変換に対する externT 文字の終了文字シーケンスを生成します (std::codecvt<InternT,ExternT,State>の仮想プロテクテッドメンバ関数)
do_encoding [仮想]	一定であれば、ひとつの internT 文字を生成するのに必要な externT の文字数を返します (std::codecvt<InternT,ExternT,State>の仮想プロテクテッドメンバ関数)
do_always_noconv [仮想]	ファセットがすべての有効な引数の値に対して恒等変換をエンコードするかどうか調べます (std::codecvt<InternT,ExternT,State>の仮想プロテクテッドメンバ関数)
do_length [仮想]	与えられた internT バッファへの変換によって消費されるであろう externT 文字列の長さを計算します (std::codecvt<InternT,ExternT,State>の仮想プロテクテッドメンバ関数)
do_max_length [仮想]	単一の internT 文字に変換される可能性のある externT の最大文字数を返します (std::codecvt<InternT,ExternT,State>の仮想プロテクテッドメンバ関数)

std::codecvt_base から継承

メンバ型	定義
enum result { ok, partial, error, noconv };	スコープなし列挙型

列挙定数	定義
ok	変換はエラーなしで完了しました
partial	変換元の文字は全部は変換されませんでした
error	無効な文字に遭遇しました
noconv	変換は必要ありません、入力と出力の型は同じです

例

Run this code

#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	mbrtoc32 / c32rtomb	codecvt<char32_t, char, mbstate_t> codecvt_utf8<char32_t> codecvt_utf8<wchar_t>(Windows以外)	codecvt_utf16<char32_t> codecvt_utf16<wchar_t>(Windows以外)
システム全体: UTF-32(Windows以外) UCS2(Windows)	mbsrtowcs / wcsrtombs use_facet<codecvt <wchar_t, char, mbstate_t>>(locale)	No	No

codecvt	UTF-8, UTF-16, UTF-32 を含む文字エンコーディング間の変換を行います (クラステンプレート)
codecvt_mode (C++11)(C++17で非推奨)	標準の codecvt ファセットの動作を変更するためのタグ (列挙)
codecvt_utf8 (C++11)(C++17で非推奨)	UTF-8 と UCS2/UCS4 の間で変換を行います (クラステンプレート)
codecvt_utf16 (C++11)(C++17で非推奨)	UTF-16 と UCS2/UCS4 の間で変換を行います (クラステンプレート)