std:: num_put

La clase std::num_put encapsula las reglas para formatear valores numéricos como cadenas. Específicamente, los tipos bool , long , unsigned long , long long , unsigned long long (desde C++11) , double , long double , void * , y todos los tipos convertibles implícitamente a estos (como int o float ) están soportados. Los operadores estándar de salida con formato (como cout << n ; ) utilizan la faceta std::num_put de la configuración regional del flujo de E/S para generar la representación textual de los números.

Diagrama de herencia

Si una especialización de std::num_put no está garantizada que sea proporcionada por la biblioteca estándar (ver abajo), los comportamientos de sus funciones put() y do_put() no están garantizados como se especifica.

Especializaciones

La biblioteca estándar garantiza proporcionar las siguientes especializaciones (están requeridas para ser implementadas por cualquier objeto locale ):

Además, la biblioteca estándar también garantiza proporcionar cada especialización que cumpla con los siguientes requisitos de tipo:

• CharT es uno de
  • char ,
  • wchar_t , y
  • cualquier otro tipo de contenedor de caracteres definido por la implementación que cumpla con los requisitos para un carácter sobre el cual cualquiera de los componentes de iostream pueda instanciarse; y
• OutputIt debe cumplir con los requisitos de LegacyOutputIterator .

Tipos anidados

Miembros de datos

Funciones miembro

Funciones miembro protegidas

Ejemplo

#include <iostream>
#include <iterator>
#include <locale>
#include <string>
int main()
{
    double n = 1234567.89;
    std::cout.imbue(std::locale("de_DE.UTF-8"));
    std::cout << "Conversión directa a string:\n"
              << std::to_string(n) << '\n'
              << "Salida usando una configuración regional alemana:\n"
              << std::fixed << n << '\n'
              << "Salida usando una configuración regional americana:\n";
    // usar el facet directamente
    std::cout.imbue(std::locale("en_US.UTF-8"));
    auto& f = std::use_facet<std::num_put<char>>(std::cout.getloc());
    f.put(std::ostreambuf_iterator<char>(std::cout), std::cout, ' ', n);
    std::cout << '\n';
}

Conversión directa a string:
1234567.890000
Salida usando una configuración regional alemana:
1.234.567,890000
Salida usando una configuración regional americana:
1,234,567.890000

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