Fonction vsprintf()
Exemple
Écrire une chaîne formatée dans une variable :
<?php
$number = 9;
$str = "Pékin";
$txt = vsprintf("Il y a %u millions de bicyclettes à %s.", array($number, $str));
echo $txt;
?> Définition et utilisation
La fonction vsprintf() écrit une chaîne formatée dans une variable.
Contrairement à sprintf(), les arguments de vsprintf() sont placés dans un tableau. Les éléments du tableau seront insérés aux signes pourcent (%) dans la chaîne principale. Cette fonction fonctionne "étape par étape". Au premier signe %, le premier élément du tableau est inséré, au deuxième signe %, le deuxième élément du tableau 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 suivi de "\$". Voir l'exemple deux.
Astuce : Fonctions connexes : fprintf() , vfprintf() , printf() , sprintf() et vprintf() .
Syntaxe
vsprintf( format,argarray ) 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. |
| argarray | Requis. Un tableau avec des arguments à insérer aux signes % dans la chaîne de format |
Détails techniques
| Valeur de retour : | Renvoie les valeurs du tableau sous forme de chaîne formatée |
|---|---|
| Version PHP : | 4.1.0+ |
Plus d'exemples
Exemple
Utilisation de la valeur de format %f :
<?php
$num1 = 123;
$num2 = 456;
$txt = vsprintf("%f%f", array($num1, $num2));
echo $txt;
?> Exemple
Utilisation des espaces réservés :
<?php
$number = 123;
$txt = vsprintf("Avec 2 décimales : %1\$.2f
<br>Sans décimales : %1\$u", array($number));
echo $txt;
?> Exemple
Utilisation de sprintf() pour démontrer 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 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 (minuscule)
echo sprintf("%%X = %X", $num1)."<br>"; // Nombre hexadécimal (majuscule)
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 vsprintf("[%s]", array($str1))."<br>";
echo vsprintf("[%8s]", array($str1))."<br>";
echo vsprintf("[%-8s]", array($str1))."<br>";
echo vsprintf("[%08s]", array($str1))."<br>";
echo vsprintf("[%'*8s]", array($str1))."<br>";
echo vsprintf("[%8.8s]", array($str2))."<br>";
?>