sprintf

Description

sprintf() retourne une chaîne formatée avec le format format.

La chaîne de format est composée de 0 ou plus directives : généralement des caractères qui sont recopiés tels quel (hormis %), et des spécifications, chacune d'elle disposant de son propre paramètre. Cela s'applique à sprintf() et printf().

Chaque conversion consiste, en un signe pourcentage (%), suivi d'un ou plusieurs éléments parmi ceux-ci :

1. Une option de remplissage, qui indique quel caractère sera utilisé pour le remplissage, et la taille finale de la chaîne. Le caractère de remplissage peut être un espace ou le caractère zéro (0).). La valeur par défaut est l'espace. Une autre valeur peut être spécifiée en la préfixant par un guillemet simple ('). Voir les exemples plus loin.

2. Un argument optionnel alignment specifier qui indique que le résultat doit être justifié à droite ou à gauche. Par défaut, il est justifié à gauche. Le caractère - signifie : justification à droite.

3. Argument optionnel, width specifier indique le nombre minimum de caractères que la conversion devrait retourner.

4. Argument optionnel, precision specifier indique le nombre de chiffres utilisé pour afficher un nombre à virgule flottante. Cette option n'a d'effet que sur les nombres à virgule, double. (Une autre fonction pratique pour formater les nombres est : number_format().)

5. type specifier indique le type de données passées en argument : Les types possibles sont :

   % - un signe pourcentage : aucun argument nécessaire.

   b - l'argument est traité comme un entier, et représenté comme un nombre binaire.

   c - l'argument est traité comme un entier, et représenté comme un nombre ascii.

   d - l'argument est traité comme un entier, et représenté comme un nombre décimal.

   f - l'argument est traité comme un double, et représenté comme un nombre à virgule flottante.

   o - l'argument est traité comme un entier, et représenté comme un nombre octal.

   s - l'argument est traité tel quel, et représenté comme une chaîne.

   x - l'argument est traité comme un entier, et représenté comme un nombre hexadécimal (en minuscules).

   X - l'argument est traité comme un entier, et représenté comme un nombre hexadécimal (en majuscules).

Voir aussi : printf(), sscanf(), fscanf(), et number_format().

Exemple 1. Exemple avec sprintf(): complété avec des zéros <?php $isodate = sprintf("%04d-%02d-%02d", $year, $month, $day); ?>

Exemple 2. Exemple avec sprintf(): format monétaire <?php $money1 = 68.75; $money2 = 54.35; $money = $money1 + $money2; // echo $money affichera "123.1"; $formatted = sprintf("%01.2f", $money); // echo $formatted affichera "123.10" ?>