Namespaces
Variants

    std::to_string

    Depuis fr.cppreference.net
     
    C++
    Support du compilateur
    Autonome et hébergé
    Langage
    Bibliothèque standard
    En-têtes de la bibliothèque standard
    Exigences nommées
    Macros de test de fonctionnalités (C++20)
    Bibliothèque de support du langage
    Bibliothèque de concepts (C++20)
    Bibliothèque de diagnostics
    Bibliothèque de gestion de la mémoire
    Bibliothèque de métaprogrammation (C++11)
    Bibliothèque d'utilitaires généraux
    Bibliothèque de conteneurs
    Bibliothèque d'itérateurs
    Bibliothèque de plages (ranges) (C++20)
    Bibliothèque d'algorithmes
    Bibliothèque de chaînes
    Bibliothèque de traitement de texte
    Bibliothèque numérique
    Bibliothèque de date et heure
    Bibliothèque d'entrée/sortie
    Bibliothèque du système de fichiers (C++17)
    Bibliothèque de support de la concurrence (C++11)
    Bibliothèque de contrôle d'exécution (C++26)
    Spécifications techniques
    Index des symboles
    Bibliothèques externes
     
    Bibliothèque de chaînes
     
    std::basic_string
     
    Défini dans l'en-tête <string> 
    std::string to_string( int value );
    		(1) (depuis C++11) 
    std::string to_string( long value );
    		(2) (depuis C++11) 
    std::string to_string( long long value );
    		(3) (depuis C++11) 
    std::string to_string( unsigned value );
    		(4) (depuis C++11) 
    std::string to_string( unsigned long value );
    		(5) (depuis C++11) 
    std::string to_string( unsigned long long value );
    		(6) (depuis C++11) 
    std::string to_string( float value );
    		(7) (depuis C++11) 
    std::string to_string( double value );
    		(8) (depuis C++11) 
    std::string to_string( long double value );
    		(9) (depuis C++11)

    Convertit une valeur numérique en std::string.

    Soit buf un tampon interne aux fonctions de conversion, suffisamment grand pour contenir le résultat de la conversion.

    1) Convertit un entier signé en une chaîne comme par std::sprintf(buf, "%d", value).
    2) Convertit un entier signé en une chaîne comme par std::sprintf(buf, "%ld", value).
    3) Convertit un entier signé en une chaîne comme par std::sprintf(buf, "%lld", value).
    4) Convertit un entier non signé en une chaîne comme par std::sprintf(buf, "%u", value).
    5) Convertit un entier non signé en une chaîne comme par std::sprintf(buf, "%lu", value).
    6) Convertit un entier non signé en une chaîne comme par std::sprintf(buf, "%llu", value).
    7,8) Convertit une valeur à virgule flottante en une chaîne comme par std::sprintf(buf, "%f", value).
    9) Convertit une valeur à virgule flottante en une chaîne comme par std::sprintf(buf, "%Lf", value).
    		(jusqu'à C++26)
    1-9) Convertit une valeur numérique en une chaîne comme par std::format("{}", value).
    		(depuis C++26)

    Paramètres

    value - une valeur numérique à convertir

    Valeur de retour

    Une chaîne contenant la valeur convertie.

    Exceptions

    Peut lever std::bad_alloc depuis le constructeur de std::string .

    Notes

    • Avec les types à virgule flottante std::to_string peut produire des résultats inattendus car le nombre de chiffres significatifs dans la chaîne retournée peut être zéro, voir l'exemple.
    • La valeur de retour peut différer significativement de ce que std::cout affiche par défaut, voir l'exemple.
    • std::to_string s'appuie sur les paramètres régionaux C actuels à des fins de formatage, et par conséquent des appels simultanés à std::to_string depuis plusieurs threads peuvent entraîner une sérialisation partielle des appels.
      • Les résultats des surcharges pour les types entiers ne dépendent pas des paramètres régionaux C actuels, et ainsi les implémentations évitent généralement d'accéder aux paramètres régionaux C actuels dans ces surcharges, à la fois pour la correction et la performance. Cependant, une telle évitement n'est pas garantie par la norme.
    		(jusqu'à C++26)

    C++17 fournit std::to_chars comme alternative indépendante des paramètres régionaux à plus haute performance.

    Macro de test de fonctionnalité Valeur Std Fonctionnalité
    __cpp_lib_to_string 202306L (C++26) Redéfinition de std::to_string en termes de std::format

    Exemple

    Exécuter ce code 
    #include <cstdio>
#include <format>
#include <initializer_list>
#include <iostream>
#include <string>
#if __cpp_lib_to_string >= 202306L
constexpr auto revision() { return " (post C++26)"; }
#else
constexpr auto revision() { return " (pre C++26)"; }
#endif
int main()
{
    for (const double f : {1.23456789555555, 23.43, 1e-9, 1e40, 1e-40, 123456789.0})
    {
        std::cout << "to_string:\t" << std::to_string(f) << revision() << '\n';
        // Avant C++26, la sortie de std::to_string correspond à std::printf.
        std::printf("printf:\t\t%f\n", f);
        // À partir de C++26, la sortie de std::to_string correspond à std::format.
        std::cout << std::format("format:\t\t{}\n", f);
        std::cout << "std::cout:\t" << f << "\n\n";
    }
}

    Sortie possible : 

    to_string:      1.234568 (pre C++26)
printf:         1.234568
format:         1.23456789555555
std::cout:      1.23457
to_string:      23.430000 (pre C++26)
printf:         23.430000
format:         23.43
std::cout:      23.43
to_string:      0.000000 (pre C++26)
printf:         0.000000
format:         1e-09
std::cout:      1e-09
to_string:      10000000000000000303786028427003666890752.000000 (pre C++26)
printf:         10000000000000000303786028427003666890752.000000
format:         1e+40
std::cout:      1e+40
to_string:      0.000000 (pre C++26)
printf:         0.000000
format:         1e-40
std::cout:      1e-40
to_string:      123456789.000000 (pre C++26)
printf:         123456789.000000
format:         123456789
std::cout:      1.23457e+08

    Voir aussi

    (C++11)
    		convertit une valeur entière ou à virgule flottante en wstring
    (fonction)
    (C++11) (C++11)
    		convertit une chaîne en entier non signé
    (fonction)
    (C++11) (C++11) (C++11)
    		convertit une chaîne en entier signé
    (fonction)
    (C++11) (C++11) (C++11)
    		convertit une chaîne en valeur à virgule flottante
    (fonction)
    (C++17)
    		convertit une valeur entière ou à virgule flottante en séquence de caractères
    (fonction)