print_r

(PHP 4, PHP 5, PHP 7, PHP 8)

print_rMuestra información legible para una variable

Descripción

print_r(mixed $value, bool $return = false): string|true

print_r() muestra información sobre una variable, de manera que sea legible.

print_r(), var_dump() y var_export() muestran asimismo las propiedades protegidas y privadas de un objeto. Los miembros de clases estáticas no serán mostrados.

Parámetros

value

La expresión a mostrar.

return

Si se desea obtener el resultado de print_r() en una cadena, se debe utilizar el parámetro return. Cuando este parámetro vale true, print_r() retornará la información en lugar de mostrarla.

Valores devueltos

Si se proporciona una chaîne de caractères, un entier o un nombre décimal, se mostrará su valor. Si se proporciona un tableau, los valores se mostrarán en un formato que permite ver las claves y los elementos. Un formato similar se utilizará asimismo para los objetos.

Cuando el parámetro return vale true, esta función retornará una chaîne de caractères. De lo contrario, el valor de retorno será true.

Historial de cambios

Versión Descripción
8.4.0 El tipo de retorno ha cambiado de string|bool a string|true.

Ejemplos

Ejemplo #1 Ejemplo con print_r()

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

El resultado del ejemplo sería:

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

Ejemplo #2 Ejemplo con el parámetro return

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

print_r($results);
?>

Notas

Nota:

Al utilizar el argumento return, esta función utilizaba el buffer interno de salida anterior a PHP 7.1.0, y por lo tanto no puede ser utilizada en la función de retrollamada de ob_start().

Ver también

  • ob_start() - Activa el temporizador de salida
  • var_dump() - Muestra información sobre una variable
  • var_export() - Devuelve el código PHP utilizado para generar una variable