Namespaces
Variants

std:: to_string

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

Table des matières

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)