CKTIS / C++
std::to_chars — scrivere un numero in un buffer di caratteri
std::to_chars scrive la rappresentazione testuale di un numero in un buffer fornito dal chiamante. Il risultato contiene un puntatore alla fine e un codice di errore; la funzione non aggiunge un '\0' finale.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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, dichiarata in <charconv>, scrive un numero nell’intervallo valido e scrivibile [first, last). Non aggiunge '\0' e non genera eccezioni. Considera i dati ottenuti come un intervallo di caratteri, non automaticamente come una stringa terminata da zero.
Il std::to_chars_result restituito contiene std::to_chars_result::ptr di tipo char* e std::to_chars_result::ec di tipo std::errc. Se ec == std::errc{}, la conversione è riuscita: ptr punta subito dopo l’ultimo carattere scritto e ptr - first indica la lunghezza. Se il buffer è troppo piccolo, ec == std::errc::value_too_large e ptr == last; il contenuto dell’intervallo non è specificato. Non usare quel buffer come risultato parziale.
Per gli interi, base vale 10 per impostazione predefinita e deve essere compresa tra 2 e 36. Le cifre superiori a 9 vengono scritte come a–z; i valori negativi ricevono -. L’overload per bool è eliminato. Gli overload per i numeri in virgola mobile accettano facoltativamente std::chars_format e una precisione; usano le regole di formattazione della locale "C", indipendentemente dalle impostazioni locali correnti.
L’esempio controlla ec prima di usare ptr e crea uno std::string_view con lunghezza esplicita. È destinato alla compilazione con -std=c++23; non attesta il comportamento in esecuzione in un ambiente di produzione. Le fonti eel.is presentano una bozza di lavoro in evoluzione e possono quindi contenere aggiunte successive a C++23.
Esempi
#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';
}
Risultato
ff
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.
Fonti
- 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]