(PHP 4, PHP 5, PHP 7)
printf — Affiche une chaîne de caractères formatée
Affiche une chaîne de caractères formatée.
formatLa chaîne de format est composé de zéro ou plusieurs directives : des caractères ordinaires (à l’exception de %) qui sont copiés directement dans le résultat et des spécifications de conversion, chacun ayant pour résultat de récupérer ses propres paramètre.
Une spécification de conversion qui suit ce prototype : %[flags][width][.precision]specifier.
| Drapeau | Description |
|---|---|
| - | Justifie le texte à gauche donnée la largeur du champ ; Justification à droite est le comportement par défaut. |
| + | Préfixe les nombres positives avec un signe plus + ; Par défaut seul les nombres négatifs sont préfixés avec un signe négatif. |
| (espace) | Complète le résultat avec des espaces. Ceci est par défaut. |
| 0 | Complète uniquement les nombres à gauches avec des zéros. Avec le spécificateur s ceci peut aussi compléter à droite avec des zéros. |
| '(char) | Complète le résultat avec le caractère (char). |
Un entier indiquant combien de caractères (au minimum) cette conversion doit avoir pour résultat.
Un point . suivie d'un entier dont sa signification dépend du spécificateur :
Note: Si le point est spécifié sans une valeur explicite pour la précision, 0 est assumé.
Note: Tenter d'utiliser une position supérieure à
PHP_INT_MAXgénèrera une alerte.
| Spécificateur | Description |
|---|---|
| % | 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 entier 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 (moins un). |
| E | Comme le spécificateur e mais utilise une lettre majuscule (par exemple 1.2E+2). |
| 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 à partir de PHP 5.0.3. |
| g |
Format général. Soit P égal à la précision si différent de 0, 6 si la précision est omit ou 1 si la précision est zéro. Alors, si la conversion avec le style E aurait comme exposant X : Si P > X ≥ −4, la conversion est avec style f et précision P − (X + 1). Sinon, la conversion est avec le style e et précision P - 1. |
| G | Comme le spécificateur g mais utilise 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. |
| u | L'argument est traité comme un entier et présenté comme un nombre décimal non signé. |
| 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). |
Le spécificateur de type c ignore l'alignement et la taille.
Le fait de tenter d'utiliser une combinaison d'une chaîne et de spécificateurs avec des jeux de caractères qui nécessitent plus d'un octet par caractères donnera un résultat inattendu.
Les variables seront contraints à un type approprié pour le spécificateur :
| Type | Spécificateurs |
|---|---|
| string | s |
| integer | d, u, c, o, x, X, b |
| double | g, G, e, E, f, F |
...
Retourne la taille de la chaîne affichée.
Exemple #1 printf() : divers exemples
<?php
$n = 43951789;
$u = -43951789;
$c = 65; // ASCII 65 is 'A'
// notez le double %%, cela affiche un caractère '%' littéral
printf("%%b = '%b'\n", $n); // représentation binaire
printf("%%c = '%c'\n", $c); // affiche le caractère ascii, comme la fonction chr()
printf("%%d = '%d'\n", $n); // représentation standard d'un entier
printf("%%e = '%e'\n", $n); // notation scientifique
printf("%%u = '%u'\n", $n); // représentation entière non signée d'un entier positif
printf("%%u = '%u'\n", $u); // représentation entière non signée d'un entier négatif
printf("%%f = '%f'\n", $n); // représentation en virgule flottante
printf("%%o = '%o'\n", $n); // représentation octale
printf("%%s = '%s'\n", $n); // représentation chaîne de caractères
printf("%%x = '%x'\n", $n); // représentation hexadécimal (minuscule)
printf("%%X = '%X'\n", $n); // représentation hexadécimal (majuscule)
printf("%%+d = '%+d'\n", $n); // indication du signe pour un entier positif
printf("%%+d = '%+d'\n", $u); // indication du signe pour un entier négatif
?>
L'exemple ci-dessus va afficher :
%b = '10100111101010011010101101' %c = 'A' %d = '43951789' %e = '4.39518e+7' %u = '43951789' %u = '4251015507' %f = '43951789.000000' %o = '247523255' %s = '43951789' %x = '29ea6ad' %X = '29EA6AD' %+d = '+43951789' %+d = '-43951789'
Exemple #2 printf() : spécificateurs chaînes de caractères
<?php
$s = 'monkey';
$t = 'many monkeys';
printf("[%s]\n", $s); // affichage d'une chaîne standard
printf("[%10s]\n", $s); // justification à droite avec des espaces
printf("[%-10s]\n", $s); // justification à gauche avec des espaces
printf("[%010s]\n", $s); // l'espacement nul fonctionne aussi sur les chaînes
printf("[%'#10s]\n", $s); // utilisation du caractère personnalisé de séparation '#'
printf("[%10.9s]\n", $t); // justification à droite mais avec une coupure à 8 caractères
printf("[%-10.9s]\n", $t); // justification à gauche mais avec une coupure à 8 caractères
?>
L'exemple ci-dessus va afficher :
[monkey] [ monkey] [monkey ] [0000monkey] [####monkey] [ many monk] [many monk ]