(PHP 4, PHP 5)
print_r — Affiche des informations lisibles pour une variable
print_r() affiche des informations à propos d'une variable, de manière à ce qu'elle soit lisible.
print_r(), var_dump() et var_export() afficheront également les propriétés protégées et privées d'un objet en PHP 5. Les membres des classes statiques ne seront pas affichés.
Gardez en tête que print_r() place le pointeur de tableau à la fin du tableau. Utilisez reset() pour le ramener au début.
expression
L'expression à afficher.
return
Si vous voulez obtenir le résultat de print_r() dans une chaîne,
utilisez le paramètre return. Lorsque ce paramètre vaut
TRUE, print_r() retournera l'information plutôt que de l'afficher.
Si une chaîne de caractères, un entier ou un nombre décimal est fournie, sa valeur sera affichée. Si un tableau est fourni, les valeurs seront affichées dans un format permettant de voir les clés et les éléments. Un format similaire sera également utilisé pour les objets.
Lorsque le paramètre return vaut TRUE, cette fonction
retournera une chaîne de caractères. Autrement, la valeur de retour sera TRUE.
Note:
Lorsque le paramètre
returnest utilisé, cette fonction utilise en interne le buffer de sortie, il ne peut donc pas être utilisé dans la fonction de rappel ob_start().
| Version | Description |
|---|---|
| 4.3.0 |
Ajout du paramètre return. Si vous devez
récupérer le résultat de print_r() avec une
version de PHP plus ancienne que 4.3.0, utilisez les fonctions de
bufferisation de sortie.
|
| 4.0.4 | Avant PHP 4.0.4, print_r() bouclera à l'infini si un tableau ou un objet contient une référence sur lui-même. Un exemple classique est notamment la ligne print_r($GLOBALS) car $GLOBALS est lui-même une variable globale, qui donc, contient une référence sur elle même. |
Exemple #1 Exemple avec print_r()
<pre>
<?php
$a = array ('a' => 'apple', 'b' => 'banana', 'c' => array ('x', 'y', 'z'));
print_r ($a);
?>
</pre>
L'exemple ci-dessus va afficher :
<pre>
Array
(
[a] => apple
[b] => banana
[c] => Array
(
[0] => x
[1] => y
[2] => z
)
)
</pre>
Exemple #2 Exemple avec le paramètre return
<?php
$b = array ('m' => 'monkey', 'foo' => 'bar', 'x' => array ('x', 'y', 'z'));
$results = print_r($b, true); // $results contient l'affichage de print_r
?>