PHP sprintf() Fonction
Exemple
Remplacez le signe pourcentage (%) par une variable passée en argument :
<?php
$number = 9;
$str = "Pékin";
$txt = sprintf("Il y a %u millions de vélos à %s.", $number, $str);
echo $txt;
?> Définition et Utilisation
La fonction sprintf() écrit une chaîne formatée dans une variable.
Les paramètres arg1, arg2, etc. seront insérés aux signes de pourcentage (%) dans la chaîne principale. Cette fonction fonctionne "étape par étape". Au premier signe %, arg1 est inséré, au deuxième signe %, arg2 est inséré, etc.
Remarque : S'il y a plus de signes % que d'arguments, vous devez utiliser des espaces réservés. Un espace réservé est inséré après le signe %, et consiste en le numéro de l'argument et "\$". Voir l'exemple deux.
Astuce : Fonctions connexes : printf() , vprintf() , vsprintf() , fprintf() et vfprintf()
Syntaxe
sprintf( format,arg1,arg2,arg++ ) Valeurs des Paramètres
| Paramètre | Description |
|---|---|
| format | Requis. Spécifie la chaîne et comment formater les variables qu'elle contient. Valeurs de format possibles :
Valeurs de format supplémentaires. Celles-ci sont placées entre le % et la lettre (exemple %.2f) :
Remarque : Si plusieurs valeurs de format supplémentaires sont utilisées, elles doivent être dans le même ordre que ci-dessus. |
| arg1 | Requis. L'argument à insérer au premier signe %-dans la chaîne de format |
| arg2 | Optionnel. L'argument à insérer au deuxième signe %-dans la chaîne de format |
| arg++ | Optionnel. L'argument à insérer au troisième, quatrième, etc. signe %-dans la chaîne de format |
Détails Techniques
| Valeur de Retour : | Renvoie la chaîne formatée |
|---|---|
| Version PHP : | 4+ |
Plus d'Exemples
Exemple
Utilisation de la valeur de format %f :
<?php
$number = 123;
$txt = sprintf("%f", $number);
echo $txt;
?> Exemple
Utilisation des espaces réservés :
<?php
$number = 123;
$txt = sprintf("Avec 2 décimales : %1\$.2f
<br>Sans décimales : %1\$u", $number);
echo $txt;
?> Exemple
Une démonstration de toutes les valeurs de format possibles :
<?php
$num1 = 123456789;
$num2 = -123456789;
$char = 50; // Le caractère ASCII 50 est 2
// Remarque : La valeur de format "%%" renvoie un signe de pourcentage
echo sprintf("%%b = %b", $num1)."<br>"; // Nombre binaire
echo sprintf("%%c = %c", $char)."<br>"; // Le caractère ASCII
echo sprintf("%%d = %d", $num1)."<br>"; // Nombre décimal signé
echo sprintf("%%d = %d", $num2)."<br>"; // Nombre décimal signé
echo sprintf("%%e = %e", $num1)."<br>"; // Notation scientifique (minuscule)
echo sprintf("%%E = %E", $num1)."<br>"; // Notation scientifique (majuscule)
echo sprintf("%%u = %u", $num1)."<br>"; // Nombre décimal non signé (positif)
echo sprintf("%%u = %u", $num2)."<br>"; // Nombre décimal non signé (négatif)
echo sprintf("%%f = %f", $num1)."<br>"; // Nombre à virgule flottante (sensible aux paramètres locaux)
echo sprintf("%%F = %F", $num1)."<br>"; // Nombre à virgule flottante (non sensible aux paramètres locaux)
echo sprintf("%%g = %g", $num1)."<br>"; // Plus court de %e et %f
echo sprintf("%%G = %G", $num1)."<br>"; // Plus court de %E et %f
echo sprintf("%%o = %o", $num1)."<br>"; // Nombre octal
echo sprintf("%%s = %s", $num1)."<br>"; // Chaîne
echo sprintf("%%x = %x", $num1)."<br>"; // Nombre hexadécimal (minuscules)
echo sprintf("%%X = %X", $num1)."<br>"; // Nombre hexadécimal (majuscules)
echo sprintf("%%+d = %+d", $num1)."<br>"; // Spécificateur de signe (positif)
echo sprintf("%%+d = %+d", $num2)."<br>"; // Spécificateur de signe (négatif)
?> Exemple
Une démonstration des spécificateurs de chaîne :
<?php
$str1 = "Bonjour";
$str2 = "Bonjour le monde !";
echo sprintf("[%s]", $str1)."<br>";
echo sprintf("[%8s]", $str1)."<br>";
echo sprintf("[%-8s]", $str1)."<br>";
echo sprintf("[%08s]", $str1)."<br>";
echo sprintf("[%'*8s]", $str1)."<br>";
echo sprintf("[%8.8s]", $str2)."<br>";
?>