Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources