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

CKTIS / C++

std::to_chars — escribir un número en un búfer de caracteres

std::to_chars escribe la representación textual de un número en un búfer proporcionado por quien llama. El resultado contiene un puntero al final y un código de error; la función no añade un '\0' terminador.

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

Sintaxis

#include <charconv>
std::to_chars(first, last, value);
std::to_chars(first, last, integer_value, base);
std::to_chars(first, last, floating_value, fmt);
std::to_chars(first, last, floating_value, fmt, precision);

std::to_chars, declarado en <charconv>, escribe un número en el rango válido y escribible [first, last). No añade '\0' ni lanza excepciones. Trata los datos obtenidos como un rango de caracteres, no automáticamente como una cadena terminada en nulo.

El std::to_chars_result devuelto contiene std::to_chars_result::ptr, de tipo char*, y std::to_chars_result::ec, de tipo std::errc. Cuando ec == std::errc{}, la conversión se ha realizado correctamente: ptr apunta justo después del último carácter escrito y ptr - first indica la longitud. Si el búfer es demasiado pequeño, ec == std::errc::value_too_large y ptr == last; el contenido del rango no está especificado. No uses ese búfer como resultado parcial.

Para los enteros, base es 10 de forma predeterminada y debe estar entre 2 y 36. Los dígitos mayores que 9 se escriben como a–z; los valores negativos llevan -. La sobrecarga para bool está eliminada. Las sobrecargas de punto flotante aceptan opcionalmente std::chars_format y una precisión; aplican las reglas de formato de la configuración regional "C", con independencia de la configuración actual.

El ejemplo comprueba ec antes de usar ptr y construye un std::string_view con una longitud explícita. Está pensado para compilarse con -std=c++23; no acredita el comportamiento en ejecución en un entorno de producción. Las fuentes de eel.is muestran un borrador de trabajo en evolución, por lo que pueden incluir añadidos posteriores a C++23.

Ejemplos

#include <charconv>
#include <cstddef>
#include <iostream>
#include <string_view>
#include <system_error>

int main() {
    char buffer[16];
    const std::to_chars_result result =
        std::to_chars(buffer, buffer + sizeof buffer, 255, 16);

    if (result.ec != std::errc{}) {
        std::cerr << "conversion failed\n";
        return 1;
    }

    const std::string_view text(
        buffer, static_cast<std::size_t>(result.ptr - buffer));
    std::cout << text << '\n';
}

Resultado

ff

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