Le PHP par l'exemple : printf, sprintf et vprintf

Recherche sur ce site - Search this website (enter word, expression)

Traduction - Translate (choose language)

Vous aimez cette page ?
Alors cliquez ici

Partagez, imprimez
mettez en favori...

printf , sprintf et vprintf

Voir le Manuel PHP pour printf
Voir le Manuel PHP pour sprintf
Voir le Manuel PHP pour vprintf

Description

Fonctions sur les chaînes de caractères
printf affiche une chaîne formatée
sprintf retourne une chaîne formatée
vprintf retourne un tableau formaté

Syntaxe

printf(format,chaîne), sprintf(format,chaîne) et vprintf(format,tableau)
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 à printf, sprintf et vprintf.
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 :

Le signe optionnel ne force pas le nombre à être positif/négatif mais force à utiliser le signe - ou + sur un nombre. 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é.
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 0. Par défaut, le remplissage se fait avec des espaces. Un autre caractère de remplissage peut être spécifié entre apostrophes.
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é à droite. 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 de la forme d'un point ("."), suivi par le nombre de décimales qui doivent être affichées pour les nombres décimaux. 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.
- E : comme %e mais utilise des lettres en majuscule (i.e. 1.2E+2).
- 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 décimal, et présenté ainsi (tenant compte de la locale utilisée).
- F : l'argument est traité comme un nombre décimal, et présenté ainsi (ne tenant pas compte de la locale utilisée).
- g : raccourci pour %e et %f.
- G : reccourci pour %E et %f.
- 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 (lettres en minuscules).
- X : l'argument est traité comme un entier, et présenté comme un nombre hexadécimal (lettres en majuscules).

Exemple n° 1 : Facile
Affichage de nombres
Autres commandes utilisées : array, echo
Voir d'autres exemples utilisant cette fonction

Affichage

Formats	Résultats nombre > 0	Résultats nombre < 0	Observations
Exemples basiques pour les nombres décimaux123.456 et -123.456
%%	%	%	affiche le caractère %
%b	1111011	innaceptable	binaire (ne tient compte que de la partie entière)
%c	{	innaceptable	caractère ASCII correspondant à la partie entière
%d	123	-123	entier signé
%e	1.234560e+2	-1.234560e+2	notation scientifique
%E	1.234560E+2	-1.234560E+2	notation scientifique en majuscules
%u	123	innaceptable	entier non signé
%f	123.456000	-123.456000	nombre décimal tenant compte de la locale utilisée
%F	123.456000	-123.456000	nombre décimal ne tenant pas compte de la locale utilisée
%g	123.456	-123.456	raccourci pour %e et %f
%G	123.456	-123.456	raccourci pour %E et %f
%o	173	innaceptable	nombre octal
%s	123.456	-123.456	chaîne de caractères
%x	7b	innaceptable	nombre hexadécimal
%X	7B	innaceptable	nombre hexadécimal en majuscules pour les lettres
Autres exemples
%.5f	123.45600	-123.45600	5 chiffres pour la partie décimale
%013f si positif %014f si négatif	000123.456000	-000123.456000	6 chiffres de part et d'autre de la virgule
%05d si positif %06d si négatif	00123	-00123	5 ou 6 chiffres pour un entier (le signe est considéré comme un chiffre)
%02d-%02d	02-05-2012		Jour et mois à 2 chiffres
%.2f %%	123.46 %	-123.46 %	Pourcentage avec 2 chiffres pour la partie décimale
%.4f - %.4f - %.4f - %.4f	123.4560 - 5.0000 - 64.2000 - 4897.0000		Tableau aux nombres formatés de la même manière Valeurs du tableau : 123.456, 5, 64.2, 4897

Code
PHP

<?php
$positif = 123.456;
$negatif = -123.456;
?>
<table align="center" bordercolor="#666666" border="1px"  cellpadding="2" cellspacing="0" class="normal">
<tr bgcolor="#CCCCCC" align="center"><td><b>Formats</b></td><td><b>Résultats<br />nombre > 0</b></td><td><b>Résultats<br />nombre < 0</b></td><td><b>Observations</b></td></tr>
<tr bgcolor="#DDDDDD" align="center"><td colspan="4"><span class="titre3"><b>Exemples basiques pour les nombres décimaux<?php echo $positif; ?> et <?php echo $negatif; ?></b></span></td></tr>
<tr align="center"><td>%%</td><td><?php printf('%%', $positif); ?></td><td><?php printf('%%', $negatif); ?></td><td align="left">affiche le caractère %</td></tr>
<tr align="center"><td>%b</td><td><?php printf('%b', $positif); ?></td><td><i>innaceptable</i></td><td align="left">binaire (ne tient compte que de la partie entière)</td></tr>
<tr align="center"><td>%c</td><td><?php printf('%c', $positif); ?></td><td><i>innaceptable</i></td><td align="left">caractère ASCII correspondant à la partie entière</td></tr>
<tr align="center"><td>%d</td><td><?php printf('%d', $positif); ?></td><td><?php printf('%d', $negatif); ?></td><td align="left">entier signé</td></tr>
<tr align="center"><td>%e</td><td><?php printf('%e', $positif); ?></td><td><?php printf('%e', $negatif); ?></td><td align="left">notation scientifique</td></tr>
<tr align="center"><td>%E</td><td><?php printf('%E', $positif); ?></td><td><?php printf('%E', $negatif); ?></td><td align="left">notation scientifique en majuscules</td></tr>
<tr align="center"><td>%u</td><td><?php printf('%u', $positif); ?></td><td><i>innaceptable</i></td><td align="left">entier non signé</td></tr>
<tr align="center"><td>%f</td><td><?php printf('%f', $positif); ?></td><td><?php printf('%f', $negatif); ?></td><td align="left">nombre décimal tenant compte de la locale utilisée</td></tr>
<tr align="center"><td>%F</td><td><?php printf('%F', $positif); ?></td><td><?php printf('%F', $negatif); ?></td><td align="left">nombre décimal ne tenant pas compte de la locale utilisée</td></tr>
<tr align="center"><td>%g</td><td><?php printf('%g', $positif); ?></td><td><?php printf('%g', $negatif); ?></td><td align="left">raccourci pour %e et %f</td></tr>
<tr align="center"><td>%G</td><td><?php printf('%G', $positif); ?></td><td><?php printf('%G', $negatif); ?></td><td align="left">raccourci pour %E et %f</td></tr>
<tr align="center"><td>%o</td><td><?php printf('%o', $positif); ?></td><td><i>innaceptable</i></td><td align="left">nombre octal</td></tr>
<tr align="center"><td>%s</td><td><?php printf('%s', $positif); ?></td><td><?php printf('%s', $negatif); ?></td><td align="left">chaîne de caractères</td></tr>
<tr align="center"><td>%x</td><td><?php printf('%x', $positif); ?></td><td><i>innaceptable</i></td><td align="left">nombre hexadécimal</td></tr>
<tr align="center"><td>%X</td><td><?php printf('%X', $positif); ?></td><td><i>innaceptable</i></td><td align="left">nombre hexadécimal en majuscules pour les lettres</td></tr>
<tr bgcolor="#DDDDDD" align="center"><td colspan="4"><span class="titre3"><b>Autres exemples</b></span></td></tr>
<tr align="center"><td>%.5f</td><td><?php printf('%.5f', $positif); ?></td><td><?php printf('%.5f', $negatif); ?></td><td align="left">5 chiffres pour la partie décimale</td></tr>
<tr align="center"><td>%013f si positif<br />%014f si négatif</td><td><?php printf('%013f', $positif); ?></td><td><?php printf('%014f', $negatif); ?></td><td align="left">6 chiffres de part et d'autre de la virgule</td></tr>
<tr align="center"><td>%05d si positif<br />%06d si négatif</td><td><?php printf('%05d', $positif); ?></td><td><?php printf('%06d', $negatif); ?></td><td align="left">5 ou 6 chiffres pour un entier (le signe est considéré comme un chiffre)</td></tr>
<tr align="center"><td>%02d-%02d</td><td colspan="2"><?php echo sprintf("%02d-%02d", 2, 5).'-2012'; ?></td></td><td align="left">Jour et mois à 2 chiffres</td></tr>
<tr align="center"><td>%.2f %%</td><td><?php printf('%.2f %%', $positif); ?></td><td><?php printf('%.2f %%', $negatif); ?></td><td align="left">Pourcentage avec 2 chiffres pour la partie décimale</td></tr>
<tr align="center"><td>%.4f - %.4f - %.4f - %.4f</td><td colspan="2"><?php vprintf('%.4f - %.4f - %.4f - %.4f', array(123.456, 5, 64.2, 4897)); ?></td><td align="left">Tableau aux nombres formatés de la même manière<br />Valeurs du tableau : 123.456, 5, 64.2, 4897</td></tr>
</table>

Vous pouvez sélectionner le code ou cliquer sur parenthèses, accolades et crochets pour voir leurs tenant et aboutissant.

Haut de page