(PHP 4, PHP 5, PHP 7, PHP 8)
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() affiche également les propriétés protégées et privées d'un objet. Les membres des classes statiques ne seront pas affichés.
value
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
.
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
?>
Note:
Lorsque le paramètre
return
est utilisé, cette fonction utilisait la mise en tampon (buffer) interne de sortie antérieur à PHP 7.1.0, et donc ne peut pas être utilisé dans la fonction de rappel de ob_start().