PHP sprintf()Fonctions
Manuel de référence des chaînes PHP
Exemples
Remplacez le signe de pourcentage (%) par une variable passée en paramètre :
<?php
$number = 9;
$str = "EXEMPLE";
$txt = sprintf("Il y a %u dix mille personnes qui visitent %s chaque jour !", $str, $number);
echo $txt;
?>
La sortie est la suivante :
EXAMPLE 每天有 9 万人在访问！
Définition et utilisation
La fonction sprintf() écrit une chaîne formatée dans une variable.
Les paramètres arg1, arg2, ++ seront insérés au niveau du signe de pourcentage (%) dans la chaîne principale. Cette fonction est exécutée étape par étape. Au premier signe %, arg1 est inséré, au deuxième signe %, arg2 est inséré, et ainsi de suite.
Remarque :S'il y a plus de signes % que de paramètres arg, vous devez utiliser des espaces réservés. Un espace réservé est inséré après le signe % et se compose d'un nombre et de "\$". Voir l'exemple 2.
Astuce :Fonctions associées :printf()、
vprintf()、
vsprintf()、
fprintf()etvfprintf()
Syntaxe
sprintf(format,arg1,arg2,arg++)
| Parameters |
Description |
| format |
Obligatoire. Spécifie la chaîne et comment formater les variables qu'elle contient. Valeurs de format possibles :
- %% - Renvoie un signe de pourcentage %
- %b - Nombre binaire
- %c - Le caractère correspondant à la valeur ASCII
- %d - Nombre décimal signé (négatif, zéro, positif)
- %e - Notation scientifique en minuscules (par ex. 1.2e+2)
- %E - Notation scientifique en majuscules (par ex. 1.2E+2)
- %u - Nombre décimal non signé (supérieur ou égal à 0)
- %f - Nombre à virgule flottante (paramètres locaux)
- %F - Nombre à virgule flottante (paramètres non locaux)
- %g - Plus court entre %e et %f
- %G - Le plus court entre %E et %f
- %o - Nombre octal
- %s - Chaîne de caractères
- %x - Nombre hexadécimal (lettres minuscules)
- %X - Nombre hexadécimal (lettres majuscules)
Valeurs de format supplémentaires. Doivent être placées entre % et la lettre (par ex. %.2f) :
- + (Ajoute + ou - devant un nombre pour définir son signe. Par défaut, seuls les nombres négatifs sont marqués, les nombres positifs ne le sont pas)
- ' (Spécifie ce qu'il faut utiliser comme remplissage, la valeur par défaut est l'espace. Il doit être utilisé avec le spécificateur de largeur. Par exemple : %'x20s (en utilisant "x" comme remplissage))
- - (Aligne à gauche la valeur de la variable)
- [0-9] (Spécifie la largeur minimale de la valeur de la variable)
- .[0-9] (Spécifie le nombre de chiffres décimaux ou la longueur maximale de la chaîne)
Remarque :Si plusieurs valeurs de format ci-dessus sont utilisées, elles doivent être utilisées dans l'ordre ci-dessus et ne peuvent pas être réorganisées.
|
| arg1 |
Obligatoire. Spécifie le paramètre à insérer au premier signe % dans la chaîne de format. |
| arg2 |
Facultatif. Spécifie le paramètre à insérer au deuxième signe % dans la chaîne de format. |
| arg++ |
Facultatif. Spécifie les paramètres à insérer aux troisième, quatrième, etc. signes % dans la chaîne de format. |
Détails techniques
| Valeur de retour : |
Retourne la chaîne formatée. |
| Version de PHP : |
4+ |
Plus d’exemples
Exemple 1
Utilisation de la valeur de format %f :
<?php
$number = 123;
$txt = sprintf("%f",$number);
echo $txt;
?>
Exécuter l'exemple »
Exemple 2
Utilisation d'espaces réservés :
<?php
$number = 123;
$txt = sprintf("Avec deux décimales : %1\$.2f
<br>Sans décimales : %1\$u",$number);
echo $txt;
?>
Exécuter l'exemple »
Exemple 3
Démonstration de toutes les valeurs de format possibles :
<?php
$num1 = 123456789;
$num2 = -123456789;
$char = 50;
echo sprintf("%%b = %b",$num1)."<br>";
echo sprintf("%%c = %c",$char)."<br>";
echo sprintf("%%d = %d",$num1)."<br>";
echo sprintf("%%d = %d",$num2)."<br>";
echo sprintf("%%e = %e",$num1)."<br>";
echo sprintf("%%E = %E",$num1)."<br>";
echo sprintf("%%u = %u",$num1)."<br>";
echo sprintf("%%u = %u",$num2)."<br>";
echo sprintf("%%f = %f",$num1)."<br>";
echo sprintf("%%F = %F",$num1)."<br>";
echo sprintf("%%g = %g",$num1)."<br>";
echo sprintf("%%G = %G",$num1)."<br>";
echo sprintf("%%o = %o",$num1)."<br>";
echo sprintf("%%s = %s",$num1)."<br>";
echo sprintf("%%x = %x",$num1)."<br>";
echo sprintf("%%X = %X",$num1)."<br>";
echo sprintf("%%+d = %+d",$num1)."<br>";
echo sprintf("%%+d = %+d",$num2)."<br>";
?>
Exemple 4
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>";
?>
Exécuter l'exemple »
Manuel de référence des chaînes PHP Autres extensions