sprintf
Retourne une chaîne formatée
&reftitle.description;
stringsprintf
stringformat
mixedargs
mixed...
Retourne une chaîne formatée, avec le format
format, en utilisant les arguments
args.
&reftitle.parameters;
format
La chaîne de format est composée de zéro, une ou plusieurs directives :
les caractères ordinaires (à l'exception de %)
qui sont copiés directement dans le résultat, et des
spécifications de conversion, qui exploitent
chacune un des arguments passés après la chaîne de format.
Ces formats s'appliquent à sprintf
et printf.
Chaque spécification de conversion est constituée d'un signe
de pourcentage (%), suivi d'un ou plusieurs
des éléments suivants, dans cet ordre :
Un signe optionnel qui force un nombre à être
positif ou négatif (- ou +). Par défaut, seul le signe - est utilisé
sur un nombre s'il est négatif. Ce spécificateur force également
les nombres positifs à avoir un signe + d'attaché, et a été ajouté
en PHP 4.3.0.
Un remplisseur optionnel qui indique
quel caractère sera utilisé pour compléter le résultat
jusqu'à la longueur requise. Ce peut être le caractère d'espace,
ou le caractère &zero;. Par défaut, le remplissage
se fait avec des espaces. Un autre caractère de remplissage peut
être spécifié en le préfixant avec un guillemet simple
(') : voir les exemples ci-dessous.
Un spécificateur d'alignement qui indique
si le résultat doit être aligné à gauche ou à droite. Par
défaut, le résultat est aligné à gauche. Le caractère
- fera que le résultat sera justifié à gauche.
Un nombre optionnel, spécificateur de taille
indique le nombre minimum de caractères que cette conversion doit
fournir en résultat.
Un spécificateur de précision qui indique
le nombre de décimales qui doivent être affichées pour les nombres
à virgule flottante. Lorsque vous utilisez ce spécificateur dans une
chaîne, il agit comme un point de coupure, définissant une limite
maximale de caractères de la chaîne.
Un spécificateur de type qui indique le type
avec lequel l'argument sera traité. Plusieurs types possibles :
% : un caractère de pourcentage littéral.
Aucun argument n'est nécessaire.
b : l'argument est traité comme un entier,
et présenté comme un nombre binaire.
c : l'argument est traité comme un entier,
et présenté comme le caractère de code ASCII correspondant.
d : l'argument est traité comme un entier,
et présenté comme un nombre décimal signé.
e : l'argument est traité comme une notation
scientifique (e.g. 1.2e+2).
Le spécificateur de précision représente le nombre de chiffres après
la virgule depuis PHP 5.2.1. Dans les versions antérieures, il a été
pris comme nombre des chiffres significatifs (au moins un).
u : l'argument est traité comme un entier,
et présenté comme un nombre décimal non signé.
f : l'argument est traité comme un nombre à
virgule flottante (type float), et présenté comme un
nombre à virgule flottante (tenant compte de la locale utilisée).
F : l'argument est traité comme un nombre à
virgule flottante (type float), et présenté comme un
nombre à virgule flottante (ne tenant pas compte de la locale
utilisée). Disponible depuis PHP 4.3.10 et PHP 5.0.3.
o : l'argument est traité comme un entier,
et présenté comme un nombre octal.
s : l'argument est traité et
présenté comme une chaîne de caractères.
x : l'argument est traité comme un entier,
et présenté comme un nombre hexadécimal (les lettres en minuscules).
X : l'argument est traité comme un entier,
et présenté comme un nombre hexadécimal (les lettres en majuscules).
La chaîne de format supporte le numérotage
et l'échange d'arguments. Par exemple :
Échange d'arguments
]]>
Ainsi, cet exemple peut afficher :
"Il y a 5 singes dans le bananier".
Mais imaginez que la chaîne de format soit créée dans un script
séparé, comme une bibliothèque : cela arrive lorsqu'il faut
internationaliser une application. Suivant la langue, il faudra peut-être
écrire :
Échange d'arguments (2)
]]>
Ici, nous voyons bien le problème. L'ordre des arguments a été changé,
et ne correspond plus à l'ordre des arguments dans le script PHP.
Nous souhaitons laisser le code PHP intact, mais simplement indiquer
dans la chaîne de formatage l'ordre dans lequel les arguments doivent
être utilisés. La chaîne de format peut être réécrite ainsi :
Échange d'arguments (3)
]]>
Un des avantages est que vous pouvez désormais exploiter plusieurs fois les
arguments sans les répéter. Ainsi :
Échange d'arguments (4)
]]>
args
...
&reftitle.returnvalues;
Retourne une &string; créée suivant le format
format.
&reftitle.changelog;
&Version;
&Description;
4.0.6
Ajout du support de l'argument d'échange
&reftitle.examples;
printf : divers exemples
]]>
&example.outputs;
printf : spécificateurs chaînes de caractères
]]>
&example.outputs;
sprintf : entier sans espace
]]>
sprintf : formatage de devises
]]>
sprintf: notation scientifique
]]>
&reftitle.seealso;
printf
sscanf
fscanf
vsprintf
number_format