SPRINTF

Syntaxe

Paramètres

Retour

Description

Cette fonction permet d'effectuer l'écriture de texte selon un certain format à partir d'un tampon.

Remarques

• Il faut s'assurer que le tampon recevant les données soit assez grand pour recevoir le contenu demandé. Toutefois, il est très difficile d'anticiper la taille qu'aura le résultat avec le formatage de données. Cependant, on devrait prévoir au moins 6 caractères pour un entier court, 20 caractères par un entier long, 30 pour des nombres réels et faire un calcul avec strlen dans le cas d'une chaîne de caractères à y introduire.
• Le comportement de cette fonction est similaire à la fonction «printf» sauf qu'il retourne son résultat dans une chaîne de caractères plutôt que de l'afficher.
• Après le paramètre de formatage, la fonction attend au moins un nombre égale ou supérieur de paramètres que le nombre de «%i», «%c»,... réunit.
• Il peut être judicieux d'utiliser plusieurs fois cette fonction pour préparer par morceaux de pièces trop complexes pour une simple fonction «printf».
• Contrairement à ce que l'on pourrait croire, cette fonction n'est pas définie dans l'entête «cstring» mais plutôt dans «cstdio».
• Si votre compilateur de langage de programmation C ou C++ supporte la fonction «snprintf», il serait plutôt préférable d'utiliser cette fonction. Malheureusement, elle n'a été incluse quand dans le standard C++ de 2011, il n'est donc pas nécessairement supporté sur votre plate-forme.
• Retourne le nombre de caractères écrits : sprintf renvoie un entier correspondant au nombre de caractères écrits (sans compter le caractère nul \0 de fin). Exemple :
1. char buffer[50];
2. int len = sprintf(buffer, "Valeur : %d", 42);
3. std::cout << "Longueur : " << len << " | Contenu : " << buffer << std::endl;

Ici, len vaudra 10, car la chaîne "Valeur : 42" contient 10 caractères.

• Risque de dépassement de mémoire (Buffer Overflow) : sprintf n'effectue aucun contrôle sur la taille du tampon où elle écrit. Si la chaîne formatée dépasse la capacité du tableau tampon, cela peut entraîner un dépassement de mémoire et potentiellement un comportement indéfini. Solution : utiliser snprintf, limitant le nombre de caractères écrits :
  1. snprintf(buffer, sizeof(buffer), "Texte très long %d", 100);
• Ne gère pas directement les types std::string : sprintf fonctionne avec des chaînes de caractères de type char*, mais pas directement avec std::string. Il faut donc utiliser la méthode .c_str() pour extraire un char* :
1. std::string name = "Alice";
2. char buffer[50];
3. sprintf(buffer, "Nom : %s", name.c_str());

De plus, il est préférable d'utiliser std::ostringstream en C++ moderne pour la gestion des chaînes de caractères.

• Gestion des nombres flottants et précision : sprintf permet de contrôler la précision des nombres à virgule flottante :
1. char buffer[50];
2. sprintf(buffer, "%.2f", 3.14159);

Cela affichera "3.14", car %.2f arrondit à deux chiffres après la virgule. Cela est utile pour formater des nombres monétaires, scientifiques ou des données numériques.

• Support des différents formats (décimal, hexadécimal, octal) : sprintf permet d'afficher un entier sous différentes bases :
1. char buffer[50];
2. sprintf(buffer, "%.2f", 3.14159);

Résultat :

Décimal: 255, Hex: ff, Octal: 377

Ceci est particulièrement utile en programmation système et développement embarqué.

• Alternative en C++ moderne : std::ostringstream : sprintf est souvent remplacée par std::ostringstream en C++ moderne, étant plus sûr et plus flexible :
1. #include <sstream>
2. #include <iostream>
3.  
4. int main() {
5.     std::ostringstream oss;
6.     oss << "Valeur : " << 42;
7.     std::string result = oss.str();
8.     std::cout << result << std::endl;
9. }

Cela évite les problèmes de buffer overflow et facilite la gestion des std::string.

• Performance et impact mémoire : sprintf est généralement plus rapide que std::ostringstream, car elle travaille directement avec des tableaux de caractères plutôt qu'avec des objets dynamiques. Cependant, elle est moins sûre et plus difficile à déboguer, notamment lorsqu'il s'agit de grands tampons. Son utilisation est donc recommandée dans des applications critiques en performances, mais avec des précautions pour éviter les erreurs de mémoire.

Exemple

Voici divers exemple d'affichages de format :

Essayer maintenant !

on obtiendra le résultat suivant :

Voir également

Langage de programmation - C++ - Référence de procédures et fonctions - fprintf
Langage de programmation - C++ - Référence de procédures et fonctions - printf
Langage de programmation - C - Référence de procédures et fonctions - sprintf

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 734.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 248.