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 quels (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 :
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.
Un argument optionnel alignment spécifier 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.
Argument optionnel, width spécifier indique le nombre minimum de caractères que la conversion devrait retourner.
Argument optionnel, precision spécifier indique le nombre de chiffres utilisé pour afficher un nombre à virgule flottante. Cette option n'a d'effet que sur les nombres à virgule de type double (Une autre fonction pratique pour formater les nombres est : number_format()).
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. |
u - l'argument est traité comme un entier, et représenté comme un nombre décimal non signé. |
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). |
A partir de PHP 4.0.6, le paramètre format supportera aussi la numérotation des arguments, et leur échange. Par exemple :
Voir aussi printf(), sscanf(), fscanf() et number_format().
Précédent | Sommaire | Suivant |
soundex | Niveau supérieur | strncasecmp |