Langage de programmation - PHP - Référence de procédures et fonctions

SPRINTF	Imprime une chaine de recherche formaté
PHP 4+

Syntaxe

function sprintf($format);

function sprintf($format,$...);

Paramètres

Nom	Description
$format	Ce paramètre permet d'indiquer le format à interpréter. Il est a noter que un ou plusieurs des spécificateurs suivants peuvent être inclus dans le format et il utilisera un argument supplémentaire pour chaque spécificateurs:
	Spécificateur	Description
	%c	Ce spécificateur indique d'insérer à cette position un caractère contenu dans la liste des arguments après le texte
	%d	Ce spécificateur indique d'insérer à cette position un entier sous forme décimal contenu dans la liste des arguments après le texte
	%f	Ce spécificateur indique d'insérer à cette position un nombre à virgule flottante contenu dans la liste des arguments après le texte
	%i	Ce spécificateur indique d'insérer à cette position un entier contenu dans la liste des arguments après le texte
	%o	Ce spécificateur indique d'insérer à cette position un entier sous forme octal contenu dans la liste des arguments après le texte
	%s	Ce spécificateur indique d'insérer à cette position une chaine de caractères contenu dans la liste des arguments après le texte
	%x	Ce spécificateur indique d'insérer à cette position un entier sous forme hexadécimal contenu dans la liste des arguments après le texte
	Il est possible d'ajouter une précision du nombre décimal afficher en insérant le nombre entre le symbole de pourcentage et la lettre.
$...	Ce paramètre permet d'indiquer les arguments optionnel a substituer dans le formatage

Retour

Valeur	Description
chaine de caractères	Ces valeurs permettent d'indiquer le résultat correspondant au formatage.

Description

Cette fonction effectue l'écriture de texte selon un certain format à partir d'un tampon.

Remarques

Après le paramètre de formatage, la fonction attend au moins un nombre égale ou supérieur de paramètres que le nombre de «%i», «%c»,... réunit.
Il est préférable d'éviter d'utiliser des chaines de caractères Unicode ou avec plus d'un octet par caractère, car il donnera des résultats puisqu'il est conçu pour traiter les caractères avec un seul octet.
Si vous tentez d'utiliser une position supérieur à la valeur PHP_INT_MAX, un avertissement sera affiché.
Cette fonction tire ses origines de la fonction du même nom du langage de programmation C, sprintf, et à de ce fait ses comportements parfois indésirable.

Exemple

Voici un exemple montrant une classique de cette fonction :


				
					<?php
					echo "sprintf(\"%.1f\",30.2)=".sprintf("%.1f",30.2)."<br />";
					echo "sprintf(\"%02d\",1)=".sprintf("%02d",1)."<br />";
					?>

on obtiendra le résultat suivant :

sprintf("%.1f",30.2)=30.2 sprintf("%02d",1)=01

Voici un exemple montrant comment écrire une date ISO avec cette fonction :


				<?php
function DateToString($Year,$Month,$Day) {
    return sprintf("%04d-%02d-%02d",$Year,$Month,$Day);

}
 
echo "1900-01-01=".DateToString(1900,1,1)."<br />";

echo "2010-01-12=".DateToString(2010,1,12)."<br />";

echo "2012-04-05=".DateToString(2012,4,5)."<br />";

echo "2012-12-24=".DateToString(2012,12,24)."<br />";

?>

on obtiendra le résultat suivant :

1900-01-01=1900-01-01 2010-01-12=2010-01-12 2012-04-05=2012-04-05 2012-12-24=2012-12-24

Dernière mise à jour : Dimanche, le 5 avril 2015

Section courante

A propos

Section administrative du site

SPRINTF