Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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