(PHP 4, PHP 5, PHP 7, PHP 8)
print_r — Affiche des informations lisibles pour une variable
Description
print_r(mixed
$value
, bool
$return
=
false
): string|bool
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.
Liste de paramètres
-
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.
Valeurs de retour
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
.
Exemples
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
?>
Notes
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().
Voir aussi
- ob_start() - Enclenche la temporisation de sortie
- var_dump() - Affiche les informations d'une variable
- var_export() - Retourne le code PHP utilisé pour générer une variable