CKTIS / C++
std::to_string — convertir un nombre en texte
std::to_string, fourni par <string>, renvoie la représentation textuelle d’un nombre sous forme de std::string. Cette fiche porte sur C++23, notamment sur les limites du formatage des nombres à virgule flottante et la différence avec le projet de norme plus récent.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#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) crée et renvoie un std::string contenant la représentation d’un nombre. Cette fonction nécessite <string> et n’affiche rien par elle-même. Ses surcharges acceptent int, unsigned, long, unsigned long, long long, unsigned long long, float, double et long double. Les entiers sont écrits en base décimale, avec un signe - pour les valeurs négatives.
En C++23, la conversion se comporte comme le formatage correspondant par sprintf. Les valeurs finies à virgule flottante utilisent la notation à virgule fixe, avec six chiffres après le séparateur décimal. Ce séparateur dépend de la locale C globale. Les petites valeurs peuvent être arrondies à zéro. Dans la locale "C", std::to_string(1e-7) peut produire "0.000000" avec un arrondi au plus proche. Si sprintf tient compte du mode d’arrondi actif, un arrondi vers le haut peut donner "0.000001" à la place. Ne considère pas cette fonction comme une représentation sans perte de nombres à virgule flottante quelconques.
La fonction ne prend aucun argument permettant de choisir une base ou une précision. Comme dans l’exemple, tu peux concaténer le texte renvoyé avec un autre std::string. Cette fonction convertit un nombre en texte ; elle ne convertit pas un texte en nombre par analyse.
Périmètre de version : cette fiche concerne C++23, conformément à l’option du compilateur du dépôt ; le comportement à l’exécution en production n’est pas attesté. Le projet actuel aux adresses fournies spécifie déjà le résultat comme format("{}", val) et signale des résultats différents pour les nombres à virgule flottante par rapport à C++23. N’applique pas ce comportement plus récent à C++23.
Exemples
#include <iostream>
#include <string>
int main() {
const std::string message = std::string("count=") + std::to_string(-42);
std::cout << message << '\n';
}
Résultat
count=-42
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.