print_r
(PHP 4, PHP 5)
print_r — Affiche des informations lisibles pour une variable
Description
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.
Liste de paramètres
-
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 vautTRUE
, 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
.
Notes
Note:
Lorsque le paramètre
return
est utilisé, cette fonction utilise en interne le buffer de sortie, il ne peut donc pas être utilisé dans la fonction de rappel ob_start().
Historique
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. |
Exemples
Exemple #1 Exemple avec print_r()
<pre>
<?php
$a = array ('a' => 'apple', 'b' => 'banana', 'c' => array ('x', 'y', 'z'));
print_r ($a);
?>
</pre>
<?php
$b = array ('m' => 'monkey', 'foo' => 'bar', 'x' => array ('x', 'y', 'z'));
$results = print_r($b, true); // $results contient l'affichage de print_r
?>
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