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 может использовать только фацеты codecvt , которые определяют 1:N преобразование, то есть он должен иметь возможность обрабатывать один внутренний символ за раз при записи в файл.

При выполнении преобразований N:M эта функция может возвращать std::codecvt_base::partial после обработки всех исходных символов ( from_next == from_end ). Это означает, что для завершения преобразования требуется ещё один внутренний символ (например, при преобразовании UTF-16 в UTF-8, если последний символ в исходном буфере является старшим суррогатом).

Влияние на 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++.

Смотрите также