(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.
L'expression à afficher.
Si vous voulez obtenir le résultat de print_r() dans une chaîne, utilisez le paramètre return . Si ce paramètre vaut TRUE, print_r() retournera ce qu'il aurait affiché (ce qu'il fait par défaut).
Si une chaîne de caractères, un entier ou un nombre à virgule flottante 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.
Note: Cette fonction utilise en interne le buffer de sortie avec ce paramètre, 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
?>