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
- C++ working draft — Input/output library [input.output]
- C++ working draft — Primitive numeric conversions [charconv]
- C++ working draft — Header <charconv> synopsis [charconv.syn]
- C++ working draft — Primitive numeric output conversion [charconv.to.chars]
- C++ working draft (HTML rendering on eel.is) — Primitive numeric output conversion [charconv.to.chars]