print_r

(PHP 4, PHP 5)

print_r — Imprime información legible para humanos sobre una variable

Descripción

mixed print_r ( mixed $expresion [, bool $devolver ] )

print_r() despliega información sobre una variable en una forma que es apta para su lectura por humanos.

print_r(), var_dump() y var_export() mostrarán también propiedades protegidas y privadas de objetos con PHP 5.

Recuerde que print_r() desplazará el apuntador de la matriz al final. Use reset() para llevarlo de vuelta al comienzo.

Lista de parámetros

expresion: La expresión a ser impresa.
devolver: Si quisiera capturar la salida de print_r(), use el parámetro devolver . Si este parámetro recibe el valor TRUE, print_r() devolverá su salida, en lugar de imprimirla (cosa que hace por omisión).

Valores retornados

Si se entrega una variable tipo string, integer o float, el valor mismo será impreso. Si se entrega un array, los valores serán presentados en un formato que muestra las claves y los elementos. Una notación parecida es usada para variables tipo object.

Notes

Note: This function internally uses the output buffering with this parameter so it can not be used inside ob_start() callback function.

Registro de cambios

Versión	Descripción
4.3.0	Se agregó el parámetro `devolver` . parameter was added. Si necesita capturar la salida de print_r() con una versión anterior de PHP, use las funciones de control de salida.
4.0.4	Antes de PHP 4.0.4, print_r() continuará ejecutándose indefinidamente si se le entrega una variable tipo array u object que contenga una referencia directa o indirecta a sí misma. Un ejemplo es print_r($GLOBALS) ya que la variable $GLOBALS es una variable global que contiene una referencia a sí misma.

Ejemplos

Example#1 Ejemplo de print_r()


<pre>
<?php
$a = array ('a' => 'manzana', 'b' => 'banano', 'c' => array ('x', 'y', 'z'));
print_r ($a);
?>
</pre>

El resultado del ejemplo seria:

<pre>
Array
(
    [a] => manzana
    [b] => banano
    [c] => Array
        (
            [0] => x
            [1] => y
            [2] => z
        )
)
</pre>

Example#2 Ejemplo del parámetro devolver


<?php
$b = array ('m' => 'mono', 'foo' => 'bar', 'x' => array ('x', 'y', 'z'));
$resultados = print_r($b, true);  // $resultados contiene ahora la salida de print_r
?>

Ver también