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

Si este facet codecvt no define una conversión, no se convierten caracteres. to_next se establece igual a to , state permanece sin cambios, y se retorna std::codecvt_base::noconv .

do_out ( state, from, from + 1 , from_next, to, to_end, to_next ) debe retornar ok si

• este codecvt facet es utilizado por basic_filebuf , y
• do_out ( state, from, from_end, from_next, to, to_end, to_next ) retornaría ok donde from ! = from_end .

Valor de retorno

Un valor de tipo std::codecvt_base::result , que indica el estado de éxito de la siguiente manera:

La especialización no convertidora std:: codecvt < char , char , std:: mbstate_t > siempre retorna std::codecvt_base::noconv .

Notas

Requiere que from <= from_end && to <= to_end y que state represente ya sea el estado de desplazamiento inicial o se haya obtenido convirtiendo los caracteres precedentes en la secuencia.

Mientras que codecvt admite conversiones N:M (por ejemplo, UTF-16 a UTF-8, donde pueden ser necesarios dos caracteres internos para decidir qué caracteres externos generar), std::basic_filebuf solo puede utilizar facetas codecvt que definan una conversión 1:N, es decir, debe poder procesar un carácter interno a la vez al escribir en un archivo.

Al realizar conversiones N:M, esta función puede retornar std::codecvt_base::partial después de consumir todos los caracteres fuente ( from_next == from_end ). Esto significa que se necesita otro carácter interno para completar la conversión (por ejemplo, al convertir UTF-16 a UTF-8, si el último carácter en el búfer fuente es un sustituto alto).

El efecto sobre state está deliberadamente sin especificar. En facetas estándar, se utiliza para mantener el estado de desplazamiento como al llamar std:: wcsrtombs , y por lo tanto se actualiza para reflejar el estado de desplazamiento después del último carácter convertido exitosamente, pero una faceta definida por el usuario es libre de usarlo para mantener cualquier otro estado, por ejemplo, contar el número de caracteres especiales encontrados.

Ejemplo

#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ß水🍌"
    // nota que lo siguiente puede hacerse con wstring_convert
    std::mbstate_t mb{}; // estado de desplazamiento inicial
    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);
    // comprobación de errores omitida por brevedad
    external.resize(to_next - &external[0]);
    std::cout << "The string in narrow multibyte encoding: " << external << '\n';
}

The string in narrow multibyte encoding: zß水🍌

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares publicados anteriormente de C++.

Véase también