Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::chars_format — formato de conversión de punto flotante

std::chars_format selecciona la notación de punto flotante para std::to_chars y las reglas de lectura para std::from_chars. Ofrece los formatos general, fixed, scientific y hex; no establece la precisión por sí mismo.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <charconv>
std::chars_format::general
std::chars_format::fixed
std::chars_format::scientific
std::chars_format::hex

std::chars_format, declarado en <charconv>, es una enumeración de ámbito y un tipo de máscara de bits que usan las sobrecargas de punto flotante de std::to_chars y std::from_chars. Los valores numéricos de scientific, fixed y hex no están especificados; general equivale a fixed | scientific. En una conversión, pasa uno de los valores con nombre, no una combinación arbitraria de bits.

Para la salida, std::chars_format::fixed selecciona la notación decimal sin exponente, mientras que std::chars_format::scientific selecciona la notación decimal con exponente. std::chars_format::general elige entre estas formas. std::chars_format::hex selecciona la notación hexadecimal con un exponente de potencia de dos marcado con p, sin prefijo 0x.

La precisión es un argumento independiente de std::to_chars: para fixed y scientific, indica los dígitos posteriores al separador decimal; para general, indica la precisión en cifras significativas. No la interpretes como el número de decimales en todos los formatos. La función no añade un terminador nulo; comprueba ec y usa el rango que termina en ptr.

Para la entrada mediante std::from_chars, scientific requiere un exponente, fixed no lo permite y el formato predeterminado general acepta ambas formas. El formato hex no consume un prefijo 0x: con 0x123, puede analizar correctamente solo 0 y dejar x123. Si es necesario consumir toda la entrada, comprueba tanto ec como ptr == last.

Ejemplos

#include <charconv>
#include <iostream>
#include <system_error>

int main() {
    const std::chars_format formats[] = {
        std::chars_format::fixed,
        std::chars_format::scientific,
        std::chars_format::general
    };

    for (auto fmt : formats) {
        char buffer[64];
        const auto result = std::to_chars(
            buffer, buffer + sizeof buffer, 12.5, fmt, 3);
        if (result.ec != std::errc{}) {
            std::cerr << "conversion failed\n";
            return 1;
        }
        std::cout.write(buffer, result.ptr - buffer);
        std::cout << '\n';
    }
}

Resultado

12.500
1.250e+01
12.5

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes