codecvt::do_in

呼叫的虛擬函式轉換外部 Byte的序列轉換成內部 CharType. 的序列。

virtual result do_in(
    StateType& _State,
    const Byte* _First1, 
    const Byte* _Last1, 
    const Byte*& _Next1,
    CharType* _First2,
    CharType* _Last2,
    CharType*& _Next2,
) const;

參數

  • _State
    會維護對成員函式的呼叫之間的轉換狀態。

  • _First1
    要轉換的序列開頭的指標。

  • _Last1
    要轉換的序列結尾的指標。

  • _Next1
    在轉換的序列結尾的指標,而字組中的第一個未轉換的字元。

  • _First2
    要進行轉換的序列開頭的指標。

  • _Last2
    要進行轉換的序列結尾的指標。

  • _Next2
    在最後一個轉換的 CharType之後的至 CharType 的指標,在目的序列中的第一個未變更的字元。

傳回值

表示成功、部分作業成功或失敗的傳回。函式會傳回:

  • codecvt_base::error ,如果來源序列格式不正確。

  • codecvt_base::noconv ;如果此函式不會執行轉換。

  • codecvt_base::ok ,如果轉換成功。

  • codecvt_base::partial ,如果來源不夠,或者目的不夠大,轉換成功。

備註

_State 必須在新的來源序列開頭表示初始轉換狀態。函式修改其儲存的值,必須反映已成功轉換的目前狀態。它的儲存值為則為未指定的。

範例

"範例"一節,呼叫 do_in

需求

標題: <locale>

命名空間: std

請參閱

參考

codecvt Class