Fonction de la bibliothèque Csprintf()
Bibliothèque standard C - <stdio.h>
Description
Fonctions de la bibliothèque Cint sprintf(char *str, const char *format, ...)Envoie la sortie formatée versstrla chaîne pointée.
Déclaration
Voici la déclaration de la fonction sprintf().
int sprintf(char *str, const char *format, ...)
Paramètre
- str-- Il s'agit d'un pointeur vers un tableau de caractères, qui stocke la chaîne C.
- format-- Il s'agit de la chaîne contenant le texte à écrire dans la chaîne str. Elle peut contenir des balises de format intégrées, qui peuvent être remplacées par les valeurs spécifiées dans les arguments supplémentaires suivants et formatées selon les besoins. Les attributs de la balise de format sont : %[flags][width][.precision][length]specifier, avec les détails expliqués comme suit :
| spécificateur (spécificateur) | Sortie |
|---|---|
| c | Caractère |
| d ou i | entier décimal signé |
| e | Notation scientifique utilisant le caractère e (mantisse et exposant) |
| E | Notation scientifique utilisant le caractère E (mantisse et exposant) |
| f | Nombre à virgule flottante décimal |
| g | Sélectionne automatiquement la représentation appropriée parmi %e ou %f |
| G | Sélectionne automatiquement la représentation appropriée parmi %E ou %f |
| o | Octal signé |
| s | Chaîne de caractères |
| u | entier décimal non signé |
| x | entier hexadécimal non signé |
| X | Entier hexadécimal non signé (lettres majuscules) |
| p | Adresse de pointeur |
| n | Aucune sortie |
| % | Caractère |
| indicateurs | Description |
|---|---|
| - | Aligne à gauche dans la largeur de champ donnée ; l'alignement à droite est la valeur par défaut (voir le sous-spécificateur de largeur). |
| + | Force le résultat à être précédé d'un signe plus ou moins (+ ou -), c'est-à-dire que les nombres positifs afficheront un signe +. Par défaut, seuls les nombres négatifs sont précédés d'un signe -. |
| (espace) | Si aucun signe n'est écrit, un espace est inséré avant la valeur. |
| # | Lorsqu'il est utilisé avec les spécificateurs o, x ou X, les valeurs non nulles sont précédées de 0, 0x ou 0X, respectivement. Lorsqu'il est utilisé avec e, E et f, la sortie est forcée à contenir un point décimal, même s'il n'y a aucun chiffre après celui-ci. Par défaut, s'il n'y a aucun chiffre après celui-ci, le point décimal n'est pas affiché. Lorsqu'il est utilisé avec g ou G, le résultat est le même qu'avec e ou E, mais les zéros de fin ne sont pas supprimés. |
| 0 | Placez des zéros (0) à gauche du nombre pour le remplissage spécifié, plutôt que des espaces (voir le sous-spécificateur de largeur). |
| width | Description |
|---|---|
| (nombre) | Le nombre minimum de caractères à produire. Si la valeur de sortie est plus courte que ce nombre, le résultat sera complété par des espaces. Si la valeur de sortie est plus longue que ce nombre, le résultat ne sera pas tronqué. |
| * | La largeur n'est pas spécifiée dans la chaîne de format, mais est fournie comme argument entier supplémentaire placé avant l'argument à formater. |
| .precision | Description |
|---|---|
| .number | Pour les spécificateurs d'entiers (d, i, o, u, x, X) : la précision spécifie le nombre minimum de chiffres à écrire. Si la valeur écrite est plus courte que ce nombre, le résultat sera complété par des zéros de tête. Si la valeur écrite est plus longue que ce nombre, le résultat ne sera pas tronqué. Une précision de 0 signifie qu'aucun caractère n'est écrit. Pour les spécificateurs e, E et f : le nombre de chiffres à afficher après le séparateur décimal. Pour les spécificateurs g et G : le nombre maximal de chiffres significatifs à afficher. Pour s : le nombre maximal de caractères à afficher. Par défaut, tous les caractères sont affichés jusqu'à ce que le caractère nul de terminaison soit rencontré. Pour le type c : n'a aucun effet. Lorsqu'aucune précision n'est spécifiée, elle prend par défaut la valeur 1. Si elle est spécifiée sans valeur explicite, elle est considérée comme valant 0. |
| .* | La précision n'est pas spécifiée dans la chaîne de format, mais est fournie comme argument de valeur entière supplémentaire placé avant l'argument à formater. |
| longueur | Description |
|---|---|
| h | L'argument est interprété comme un short int ou un unsigned short int (ne s'applique qu'aux spécificateurs d'entiers : i, d, o, u, x et X). |
| l | L'argument est interprété comme un long int ou un unsigned long int, applicable aux spécificateurs d'entiers (i, d, o, u, x et X) et aux spécificateurs c (représentant un caractère large) et s (représentant une chaîne de caractères larges). |
| L | L'argument est interprété comme un long double (ne s'applique qu'aux spécificateurs à virgule flottante : e, E, f, g et G). |
- Arguments supplémentaires-- Selon la chaîne de format, la fonction peut nécessiter une série d'arguments supplémentaires, chacun contenant une valeur à insérer, remplaçant chaque balise % spécifiée dans le paramètre de format. Le nombre d'arguments doit être identique au nombre de balises %.
Valeur de retour
En cas de succès, le nombre total de caractères écrits est renvoyé, à l'exclusion du caractère nul ajouté à la fin de la chaîne. En cas d'échec, un nombre négatif est renvoyé.
Exemple
L'exemple suivant illustre l'utilisation de la fonction sprintf().
Exemple
#include <stdio.h>
#include <math.h>
int main()
{
char str[80];
sprintf(str, "The value of Pi = %f", M_PI);
puts(str);
return(0);
}
#include <math.h>
int main()
{
char str[80];
sprintf(str, "The value of Pi = %f", M_PI);
puts(str);
return(0);
}
Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :
Pi 的值 = 3.141593autres extensions