名前空間
変種
操作

std::codecvt::in, std::codecvt::do_in

提供: cppreference.com
< cpp‎ | locale‎ | codecvt
 
 
 
 
ヘッダ <locale> で定義
public:

result in( StateT& state,
           const ExternT* from,
           const ExternT* from_end,
           const ExternT*& from_next,
           InternT* to,
           InternT* to_end,

           InternT*& to_next ) const;
(1)
protected:

virtual result do_in( StateT& state,
                      const ExternT* from,
                      const ExternT* from_end,
                      const ExternT*& from_next,
                      InternT* to,
                      InternT* to_end,

                      InternT*& to_next ) const;
(2)
1) public メンバ関数。 最も派生したクラスのメンバ関数 do_in を呼びます。
2) この codecvt ファセットが変換を定義する場合、ソース範囲 [from, from_end) の外部文字を内部文字に変換し、その結果を to から始まる後続の位置に格納します。 最大 from_end - from 個の外部文字を変換し、最大 to_end - to 個の内部文字を書き込みます。 from_next および to_next を変換に成功した最後の要素の次を指すようにします。
この codecvt ファセットが変換を定義しない場合、文字は変換されません。 to_nextto と等しくなるように設定され、 state は変更されず、そして std::codecvt_base::noconv が返されます。

目次

[編集] 戻り値

以下のような成功ステータスを表す std::codecvt_base::result 型の値。

ok 変換が成功しました
partial 出力バッファに十分な空きがないか、ソースバッファが予期せず終了しました
error 変換できない文字に遭遇しました
noconv このファセットは変換を行いません。 書き込まれた出力はありません

変換を行わない std::codecvt<char, char, std::mbstate_t> の特殊化は常に std::codecvt_base::noconv を返します。

[編集] ノート

from <= from_end && to <= to_end であること、および、 state が初期シフト状態を表すかシーケンス内の先行する文字を変換することによって取得されたかのいずれかを要求します。

state に対する効果は意図的に未規定になっています。 標準のファセットでは、これは std::mbsrtowcs を呼んだときのようにシフト状態を管理し、そのため最後に処理した外部文字の後のシフト状態を反映するように更新されますが、ユーザ定義のファセットは任意の他の状態 (例えば特殊な文字に遭遇した回数など) を管理するために自由に使用することができます。

[編集]

#include <iostream>
#include <string>
#include <locale>
 
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    auto& f = std::use_facet<std::codecvt<wchar_t, char, std::mbstate_t>>(std::locale());
    std::string external = u8"z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋"
                          // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
 
    // note that the following can be done with wstring_convert
    std::mbstate_t mb = std::mbstate_t(); // initial shift state
    std::wstring internal(external.size(), '\0'); 
    const char* from_next;
    wchar_t* to_next;
    f.in(mb, &external[0], &external[external.size()], from_next,
             &internal[0], &internal[internal.size()], to_next);
    // error checking skipped for brevity
    internal.resize(to_next - &internal[0]);
 
    std::wcout << L"The string in wide encoding: " << internal << '\n';
}

出力:

The string in wide encoding: zß水𝄋

[編集] 関連項目

[仮想]
紐付けられているファイルから読み込みます
(std::basic_filebufの仮想プロテクテッドメンバ関数) [edit]
バイト文字列をワイド文字列に変換します
(std::wstring_convertのパブリックメンバ関数) [edit]
指定された状態を使用してマルチバイト文字列をワイド文字列に変換します
(関数) [edit]
[仮想]
ファイルを書き込む時などのために、文字列を internT から externT に変換します
(仮想プロテクテッドメンバ関数) [edit]