最終更新日時:
が更新

履歴 編集

function
<locale>

std::codecvt::do_unshift

protected:
  virtual result
    do_unshift(stateT& state,
               externT* to,
               externT* to_end,
               externT*& to_next) const; // (1) C++98

概要

文字列を終端するために必要な、シフト状態を戻す文字列を出力する。unshift()から呼び出される仮想関数である。

事前条件

to <= to_endが妥当な式であり、定義された動作をすること。またその結果がtrueであること。

stateは、シーケンスの先頭であれば初期化されていること。そうでなければ、シーケンス内の先行する文字を変換した結果と等しいこと。

効果

現在の状態がstateである場合に、シーケンスを終端するために付加すべき文字をtoから順に格納する。格納する要素数は(to_end - to)以下であり、to_nextは格納に成功した最後の要素の1つ次を指す。

通常これは、状態をstateT()に戻すための文字列となる。

戻り値

codecvt_base::resultの列挙値。

意味
ok シーケンスを完了した
partial stateの値に対してシーケンスを終端するために、to_end - toより多くの出力要素が必要だった
error 未規定のエラーが発生した
noconv このstate_typeでは終端処理が不要である

バージョン

言語

  • C++98

関連項目