std::codecvt::out, std::codecvt::do_out

Esta página se ha traducido por ordenador/computador/computadora de la versión en inglés de la Wiki usando Google Translate.

La traducción puede contener errores y palabras aparatosas/incorrectas. Planea sobre el texto para ver la versión original. Puedes ayudar a corregir los errores y mejorar la traducción. Para instrucciones haz clic aquí.

Definido en el archivo de encabezado `<locale>`
public: result out( stateT& state, const internT* from, const internT* from_end, const internT& from_next, externT to, externT* to_end, externT*& to_next ) const;	(1)
protected: result do_out( stateT& state, const internT* from, const internT* from_end, const internT& from_next, externT to, externT* to_end, externT*& to_next ) const;	(2)

1)

función miembro pública, llama a la función do_out miembro de la clase más derivada .

2)

Si esta faceta codecvt define una conversión, convierte los caracteres internos de la [from, from_end) rango de origen a los caracteres externos, colocando los resultados en las ubicaciones siguientes a partir de to. Convierte no más de from_end - from caracteres internos y escribe no es más que personajes to_end - to externos. Hojas from_next y to_next señalando un más allá del último elemento convertido con éxito .

Si esta faceta codecvt no define una conversión, sin caracteres se convierten. to_next se fija para ser igual a to, state es invariable, y se devuelve std::codecvt_base::noconv .

Valor de retorno

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

`ok`	conversión completa Original: conversion completed The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
`partial`	no hay suficiente espacio en la memoria intermedia de salida o final inesperado de buffer fuente Original: not enough space in the output buffer or unexpected end of source buffer The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
`error`	encontrado un carácter que no se pudo convertir Original: encountered a character that could not be converted The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
`noconv`	esta faceta no es la conversión, no hay salida por escrito Original: this facet is non-converting, no output written The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

La especialización no convertir std::codecvt<char, char, std::mbstate_t> siempre devuelve std::codecvt_base::noconv

Notas

Requiere que from <= from_end && to <= to_end state y que, o bien que representa el estado inicial de cambios o los obtenidos mediante la conversión de los caracteres anteriores en la secuencia .

Mientras codecvt apoya N: M conversiones (por ejemplo, UTF-16 a UTF-8, en el que dos caracteres internos pueden ser necesarios para decidir qué caracteres externos a la salida), std::basic_filebuf sólo puede utilizar codecvt facetas que definen un 1: Conversión de N, que es debe ser capaz de procesar un carácter interno en un momento cuando se escribe en un archivo .

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

El efecto sobre state es deliberadamente no especificado. En las facetas estándar, que se utiliza para mantener un estado de cambios como cuando se llama a std::wcsrtombs, y por tanto se actualiza para reflejar el estado de cambios después del último carácter convertido con éxito, sino una faceta definida por el usuario es libre de usarlo para mantener cualquier otro estado, por ejemplo, contar el número de caracteres especiales se encuentran .

Ejemplo

Ejecuta este código

#include <iostream>
#include <string>
#include <locale>
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\U0001d10b"; // L"zß水𝄋"

    // note that the following can be done with wstring_convert
    std::mbstate_t mb = std::mbstate_t(); // initial shift state
    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);
    // error checking skipped for brevity
    external.resize(to_next - &external[0]);

    std::cout << "The string in narrow multibyte encoding: " << external << '\n';
}

Salida:

The string in narrow multibyte encoding: zß水𝄋

Ver también

overflow [virtual]	escribe caracteres en el fichero de asociados de la zona de venta Original: writes characters to the associated file from the put area The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (función miembro virtual protegida de `std::basic_filebuf`) [editar]
to_bytes	convierte una cadena de ancho en una cadena de bytes Original: converts a wide string into a byte string The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (función miembro pública de `std::wstring_convert`) [editar]
wcsrtombs	convierte una cadena a cadena estrecha gama de caracteres multibyte, estado dado Original: converts a wide string to narrow multibyte character string, given state The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (función) [editar]
do_in [virtual]	convierte una cadena de externT a internt, como cuando al leer el archivo Original: converts a string from externT to internT, such as when reading from file The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (función miembro virtual protegida) [editar]

cppreference.com

Buscar

Espacios de nombres

Variantes

Vistas

Acciones