std::codecvt<InternT,ExternT,StateT>:: in, std::codecvt<InternT,ExternT,StateT>:: do_in

이 codecvt 패싯이 변환을 정의하지 않으면, 어떤 문자도 변환되지 않습니다. to_next 는 to 와 동일하게 설정되고, state 는 변경되지 않으며, std::codecvt_base::noconv 가 반환됩니다.

do_in ( state, from, from_end, from_next, to, to + 1 , to_next ) 는 다음과 같은 경우에 ok 를 반환해야 합니다

• 이 codecvt 패싯은 basic_filebuf 에서 사용되며,
• do_in ( state, from, from_end, from_next, to, to_end, to_next ) 는 ok 를 반환하며, 이때 to ! = to_end 입니다.

반환값

std::codecvt_base::result 타입의 값으로, 다음과 같은 성공 상태를 나타냅니다:

비변환 특수화 std:: codecvt < char , char , std:: mbstate_t > 는 항상 std::codecvt_base::noconv 를 반환합니다.

참고 사항

다음을 요구합니다: from <= from_end && to <= to_end 그리고 state 가 초기 시프트 상태를 나타내거나 시퀀스의 선행 문자들을 변환하여 얻은 상태여야 합니다.

state 에 미치는 영향은 의도적으로 명시되지 않습니다. 표준 패싯에서는 std::mbsrtowcs 를 호출할 때와 같이 시프트 상태를 유지하는 데 사용되므로, 마지막으로 처리된 외부 문자 이후의 변환 상태를 반영하도록 업데이트됩니다. 그러나 사용자 정의 패싯은 이를 사용하여 특수 문자 발생 횟수 계산과 같은 다른 상태를 자유롭게 유지할 수 있습니다.

예제

#include <iostream>
#include <locale>
#include <string>
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    auto const& f = std::use_facet<std::codecvt<wchar_t, char, std::mbstate_t>>
        (std::locale());
    std::string external = "z\u00df\u6c34\U0001d10b"; // 또는 u8"zß水𝄋"
                     // 또는 "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b"
    // 다음 작업은 wstring_convert로도 수행 가능함을 참고
    std::mbstate_t mb = std::mbstate_t(); // 초기 시프트 상태
    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);
    // 간결함을 위해 오류 검사 생략
    internal.resize(to_next - &internal[0]);
    std::wcout << L"The string in wide encoding: " << internal << '\n';
}

The string in wide encoding: zß水𝄋

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

참고 항목