Fonction vsprintf() de PHP

La fonction vsprintf()


PHP references des fonctions PHP

 (PHP 4 >= 4.1.0, PHP 5)

vsprintf() — Retourne une chaîne formatée

La fonction vsprintf()

Définition et utilisation

La fonction vsprintf () écrit une chaîne formatée à une variable.

À la différence de la fonction sprintf(), les arguments dans la fonction vsprintf (), sont placés dans un tableau. Les éléments de tableau seront insérés après le  signe pour cent (%) dans la chaîne principale. Cette fonction fonctionne « pas par pas ». Au premiers 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. …

Syntaxe

              vsprintf (format, argarray)
           
 
Paramètre Description

format

Requis. Spécifie la chaîne et comment composer les variables dans elle. Valeurs possibles de format :

  • %% - Renvoie un signe de pour cent
  • %b - Nombre binaire
  • %c - Le caractère selon la valeur d'ASCII
  • %d - Nombre décimal signé
  • %e - Notation scientifique (par exemple 1.2e+2)
  • %u - Nombre décimal non signé
  • %f - Nombre à point mobile
  • %F - Nombre à point mobile
  • %o - Nombre octal
  • %s - Chaîne
  • %x - Nombre hexadécimal (lettres minuscules)
  • %X - Nombre hexadécimal (lettres majuscules)

Valeurs additionnelles de format. Celles-ci sont placées entre les % et la lettre (exemple %.2f) :

  • + (forces + et - devant des nombres. Par défaut, seulement des nombres négatifs sont marqués)
  • '(Spécifie quoi employer comme remplissage. Le défaut est l'espace. Doit être employé ainsi que le spécificateur de largeur. Exemple : % ' de x20s (ceci emploie « x » comme remplissage)
  • - (Gauche-justifie la valeur variable)
  • [0-9] (spécifie la largeur minimum tenue)
  • . [0-9] (spécifie le nombre de chiffres décimaux ou de longueur maximum de chaîne)
Note : Si des valeurs additionnelles multiples de format sont employées, elles doivent être dans le même ordre comme ci-dessus.

argarray

Requis. Une tableaau avec des arguments à insérer chez les % signe dedans la chaîne de format


Note : S'il y a plus de % signe que des arguments, vous devez employer des textes d'attente. Un texte d'attente est inséré après le signe %, et comprend le nombre d'argument et « \ $ ». Voir l'exemple trois.


Exemple 1 Sélectionner le code

              <?php
$chaine = "Bonjour";
$number = 123;
$txt = vsprintf("%s le monde. Jour numéro %u",array($chaine,$number));
echo $txt;
?>

Le résultat du code ci-dessus sera :


              Bonjour le monde. Jour numéro 123
           
 

Exemple 2 Sélectionner le code

              <?php
$num1 = 123;
$num2 = 456;
$txt = vsprintf("%f%f",array($num1,$num2));
echo $txt;
?>

Le résultat du code ci-dessus sera :


              123.000000456.000000
           
 

Exemple 3

Utilisation des textes d'attente :

Sélectionner le code

              <?php
$number = 123;
$txt = vsprintf("Avec 2 décimales: %1\$.2f
<br />Sans décimales: %1\$u",array($number));
echo $txt;
?>

Le résultat du code ci-dessus sera :


              Avec 2 décimales : 123.00
Sans  décimales : 123


Par carabde 22 Aout 2014