isset
serialize
Fonctions de gestion des variables
PHP Manual

# print_r

(PHP 4, PHP 5)

print_r — Affiche des informations lisibles pour une variable

### Description

mixed print_r ( mixed `$expression` [, bool `$return` = false ] )

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.

### 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 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`.

### Notes

> 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().

### 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>`

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
?>`

### Voir aussi

- ob_start() - Enclenche la tamporisation de sortie
- var_dump() - Affiche les informations d'une variable
- var_export() - Retourne le code PHP utilisé pour générer une variable

isset
serialize
Fonctions de gestion des variables
PHP Manual