std::codecvt<InternT,ExternT,StateT>:: out, do_out

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

do_out ( state, from, from + 1 , from_next, to, to_end, to_next ) 는 반드시 ok 를 반환해야 합니다

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

반환값

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

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

참고 사항

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

codecvt 가 N:M 변환(예: UTF-16에서 UTF-8로의 변환, 여기서 두 개의 내부 문자가 출력할 외부 문자를 결정하는 데 필요할 수 있음)을 지원하는 반면, std::basic_filebuf 는 1:N 변환을 정의하는 codecvt 패싯만 사용할 수 있습니다. 즉, 파일에 기록할 때 한 번에 하나의 내부 문자를 처리할 수 있어야 합니다.

N:M 변환을 수행할 때, 이 함수는 모든 소스 문자를 소비한 후( from_next == from_end ) std::codecvt_base::partial 을 반환할 수 있습니다. 이는 변환을 완료하기 위해 또 다른 내부 문자가 필요함을 의미합니다 (예: UTF-16을 UTF-8로 변환할 때 소스 버퍼의 마지막 문자가 high surrogate인 경우).

state 에 미치는 영향은 의도적으로 명시되지 않았습니다. 표준 패싯에서는 std:: wcsrtombs 를 호출할 때와 같이 시프트 상태를 유지하는 데 사용되므로, 마지막으로 성공적으로 변환된 문자 이후의 시프트 상태를 반영하도록 업데이트됩니다. 그러나 사용자 정의 패싯은 이를 사용하여 다른 상태(예: 특수 문자의 개수 카운트)를 자유롭게 유지할 수 있습니다.

예제

#include <iostream>
#include <locale>
#include <string>
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::wstring internal = L"z\u00df\u6c34\U0001f34c"; // L"zß水🍌"
    // 다음 작업은 wstring_convert로도 수행 가능함
    std::mbstate_t mb{}; // 초기 시프트 상태
    std::string external(internal.size() * f.max_length(), '\0'); 
    const wchar_t* from_next;
    char* to_next;
    f.out(mb, &internal[0], &internal[internal.size()], from_next,
              &external[0], &external[external.size()], to_next);
    // 간결함을 위해 오류 검사 생략
    external.resize(to_next - &external[0]);
    std::cout << "The string in narrow multibyte encoding: " << external << '\n';
}

The string in narrow multibyte encoding: zß水🍌

결함 보고서

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

참고 항목