|
sprintf
retourne une chaîne formatée, avec
le format format, en utilisant les arguments
args.
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 spécificateur d'espacement optionnel qui dit quel spécificateur doit être utilisé pour espacer les résultats à la bonne taille de la chaîne. Cela peut être un caractère espace ou 0 (caractère zéro). Par défaut, l'espacement est effectué avec le caractère espace. Un caractère d'espacement alternatif peut être spécifié en le préfixant avec un guillemet simple ('). Voir les exemples ci-dessous.
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.
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 aligné à droite.
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 coupûre, 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). |
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). |
Depuis PHP 4.0.6, la chaîne de format supporte le numérotage et l'échange d'arguments. Par exemple :
Voir aussi printf(), sscanf(), fscanf(), vsprintf() et number_format().
Exemple 6. sprintf() : spécificateurs chaînes de caractères
L'exemple ci-dessus va afficher :
|
Précédent | Sommaire | Suivant |
soundex | Niveau supérieur | sscanf |
Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:56