Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::to_string — convertire un numero in testo

std::to_string, disponibile da <string>, restituisce la rappresentazione testuale di un numero come std::string. Questa voce riguarda C++23, comprese le limitazioni della formattazione in virgola mobile e la differenza rispetto alla bozza di lavoro più recente.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <string>

std::string std::to_string(int val);
std::string std::to_string(unsigned val);
std::string std::to_string(long val);
std::string std::to_string(unsigned long val);
std::string std::to_string(long long val);
std::string std::to_string(unsigned long long val);
std::string std::to_string(float val);
std::string std::to_string(double val);
std::string std::to_string(long double val);

std::to_string(value) crea e restituisce uno std::string contenente la rappresentazione di un numero. Richiede <string> e non stampa nulla da sola. I suoi overload accettano int, unsigned, long, unsigned long, long long, unsigned long long, float, double e long double. Gli interi sono scritti in decimale, con il segno - per i valori negativi.

In C++23, la conversione si comporta come la formattazione corrispondente tramite sprintf. I valori finiti in virgola mobile usano la notazione a virgola fissa, con sei cifre dopo il separatore decimale. Il separatore dipende dalle impostazioni locali C globali. I valori piccoli possono essere arrotondati a zero. Nelle impostazioni locali "C", std::to_string(1e-7) può produrre "0.000000" con l’arrotondamento al valore più vicino. Se sprintf rispetta la modalità di arrotondamento attiva, l’arrotondamento verso l’alto può invece produrre "0.000001". Non considerare questa funzione una rappresentazione senza perdita di numeri in virgola mobile arbitrari.

La funzione non accetta argomenti per scegliere una base o una precisione. Come nell’esempio, puoi concatenare il testo restituito con un altro std::string. Converte un numero in testo; non analizza il testo per convertirlo in numero.

Ambito della versione: questa voce riguarda C++23, in linea con l’opzione del compilatore del repository; il comportamento dell’ambiente di produzione non è attestato. La bozza attuale agli indirizzi forniti specifica già il risultato come format("{}", val) e segnala risultati in virgola mobile diversi rispetto a C++23. Non applicare questo comportamento più recente a C++23.

Esempi

#include <iostream>
#include <string>

int main() {
    const std::string message = std::string("count=") + std::to_string(-42);
    std::cout << message << '\n';
}

Risultato

count=-42

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