CKTIS / C++
std::to_chars — een getal naar een tekenbuffer schrijven
std::to_chars schrijft de tekstuele weergave van een getal naar een buffer die door de aanroeper is aangeleverd. Het resultaat bevat een eindpointer en een foutcode; de functie voegt geen afsluitende '\0' toe.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#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, gedeclareerd in <charconv>, schrijft een getal naar het geldige, schrijfbare bereik [first, last). De functie voegt geen '\0' toe en werpt geen uitzonderingen. Behandel de resulterende gegevens als een tekenbereik, niet automatisch als een nulafgesloten tekenreeks.
Het geretourneerde std::to_chars_result bevat std::to_chars_result::ptr van het type char* en std::to_chars_result::ec van het type std::errc. Als ec == std::errc{}, is de conversie geslaagd: ptr wijst direct voorbij het laatst geschreven teken en ptr - first geeft de lengte. Is de buffer te klein, dan geldt ec == std::errc::value_too_large en ptr == last; de inhoud van het bereik is niet gespecificeerd. Gebruik die buffer niet als gedeeltelijk resultaat.
Voor gehele getallen is base standaard 10 en moet deze tussen 2 en 36 liggen. Cijfers boven 9 worden geschreven als a–z; negatieve waarden krijgen -. De overbelasting voor bool is verwijderd. Overbelastingen voor drijvende-kommagetallen accepteren optioneel std::chars_format en een precisie; ze gebruiken de opmaakregels van de locale "C", ongeacht de huidige locale-instellingen.
Het voorbeeld controleert ec voordat het ptr gebruikt en maakt een std::string_view met een expliciete lengte. Het is bedoeld voor compilatie met -std=c++23; het bevestigt niet het runtimegedrag in een productieomgeving. De bronnen op eel.is tonen een evoluerend werkdocument en kunnen daarom toevoegingen bevatten die van na C++23 dateren.
Voorbeelden
#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';
}
Resultaat
ff
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.
Bronnen
- 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]