Fonction sprintf() de PHP

La fonction sprintf()


PHP references des fonctions PHP

 (PHP 4, PHP 5)

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

La fonction sprintf()

Définition et utilisation

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

Les paramètres arg1, arg2 et arg++ seront insérés avec le signe pour cent (%) dans la chaîne

Syntaxe

              sprintf (format, arg1, arg2, arg++)
           
 
Paramètre Description

format

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

  • %% - Renvoie un signe de pour cent
  • %b - Nombre binaire
  • %c - Le caractère selon la valeur ASCII
  • %d - Nombre décimal signé
  • %e - Notation scientifique (par exemple 1.2e+2)
  • %u - Nombre décimal non signé
  • %f - Nombre à virgule flottante (type float), (tenant compte de la locale utilisée).
  • %F - Nombre à à virgule flottante (type float), (ne tenant pas compte de la locale utilisée).
  • %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. Par défaut c’est l'espace. Doit être employé ainsi que le spécificateur de largeur. Exemple : % ' et  x20s (emploie « x » comme remplissage)
  • - (Justifie gauche la valeur variable)
  • [0-9] (spécifie la largeur minimum tenue )
  • . [0-9] (spécifie le nombre de chiffres décimaux ou  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.

arg1

Requis. L'argument à insérer au premier signe %- dans la chaîne de format

arg2

Facultatif. L'argument à insérer au deuxième signe %- dans la chaîne de format

arg++

Facultatif. L'argument à insérer au tiers, quatrième signe, %- dans la chaîne de format etc.


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 les signe % et comprend le nombre d'argument et « \ $ ». Voir l'exemple trois.


Exemple 1 Sélectionner le code

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

Le résultat du code ci-dessus sera :


              Bonjour monde. Jour numéro 123
           
 

Exemple 2 Sélectionner le code

              <?php
$number = 123;
$txt = sprintf("%f",$number);
echo $txt;
?>

Le résultat du code ci-dessus sera :


              123.000000
           
 

Exemple 3

Utilisation des textes d'attente :

Sélectionner le code

              <?php
$number = 123;
$txt = sprintf("Avec 2 décimales: %1\$.2f
<br />Sans décimales: %1\$u",$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