Manuel PHP
Précédent |  | Suivant

# fprintf

(PHP 5)

fprintf -- Ecrit une chaîne formatée dans un flux

## Description

int fprintf ( resource handle, string format [, mixed args])

fprintf() écrit la chaîne produite avec le format `format` dans le flux représenté par `handle`.

Le paramètre `format` est composé de zéro, une ou plusieurs directives : des caractères ordinaires (excluant `%`) qui sont copiés directement dans le résultat sans modification, et des spécifications de conversion, qui sont exploitées avec un des paramètres suivants. Cette technique s'applique à fprintf(), sprintf() et printf().

Chaque spécification de conversion est constituée d'un signe pourcentage, (`%`), suivi par un ou plusieurs éléments, dans cet ordre :

1. 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é en le préfixant avec un guillemet simple (`'`) : voir les exemples ci-dessous.

2. 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 est aligné à droite.

3. Un nombre optionnel, spécificateur de taille indique le nombre minimum de caractères que cette conversion doit fournir en résultat.

4. Un spécificateur de précision qui indique le nombre de décimales qui doivent être affichées pour les nombres à virgule flottante. Cette option n'a pas d'effet pour les autres types que float. Une auter fonction pratique pour formatter les nombres à virgule flottante est number_format().

5. Un spécificateur de type qui indique le type avec lequel l'argument sera traité. Plusieurs types possibles :

   `%` - un caractère de pourcentage lité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é.
   `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.
   `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).

Voir aussi printf(), sprintf(), sscanf(), fscanf(), vsprintf() et number_format().

## Exemples

Exemple 1. Entiers avec zéros initiaux sprintf()

`<?php $isodate = sprintf("%04d-%02d-%02d", $year, $month, $day); ?>`

Exemple 2. Format monétaire avec sprintf()

`<?php $money1 = 68.75; $money2 = 54.35; $money = $money1 + $money2; // $money contient "123.1"; $formatted = sprintf("%01.2f", $money); // $formatted contient "123.10" ?>`

Précédent | Sommaire | Suivant
explode | Niveau supérieur | get_html_translation_table