print_r

(PHP 4, PHP 5, PHP 7)

print_r — Imprime informação sobre uma variável de forma legível

Descrição

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

print_r() exibe informação sobre uma variável em uma maneira que é legível para humanos.

print_r(), var_dump() e var_export() mostrarão também propriedades protegidas e privadas de objetos com PHP 5. Membros de classes estáticas não serão mostrados.

Lembre-se de que print_r() moverá o ponteiro do array para o fim. Utilize reset() para levá-lo de volta ao início.

Parâmetros

expression

A expressão a ser impressa.

return

Se você quiser capturar a saída de print_r(), utilize o parâmetro return. Quando esse parâmetro é setado para TRUE, print_r() retornará a informação, ao invés de imprimi-la.

Valor Retornado

Se forem fornecidos string, integer ou float, o próprio valor será impresso. Se for fornecido um array, valores serão representados em um formato que mostra chaves e elementos. Notação similar é utilizada para objetos.

Quando o parâmetro return for TRUE, esta função retornará uma string. Caso contrário, o valor retornado será TRUE.

Notas

Note:

Esta função usa o interno buffer de saída com este parâmetro, então assim não pode ser usado dentro de uma função de callback para ob_start().

Changelog

Versão Descrição
4.3.0 O parâmetro return foi adicionado. Se você precisar capturar a saída de print_r() em uma função anterior do PHP, utilize funções de controle de saída.
4.0.4 Antes de PHP 4.0.4, print_r() será executada para sempre se forem fornecidos array ou objeto que contêm uma referência direta ou indireta para eles mesmos. Um exemplo é print_r($GLOBALS) porque $GLOBALS é ela própria uma variável global que contém uma referência para ela mesma.

Exemplos

Example #1 Exemplo de print_r()

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

O exemplo acima irá imprimir:

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

Example #2 Exemplo do parâmetro return

<?php
$b = array ('m' => 'monkey', 'foo' => 'bar', 'x' => array ('x', 'y', 'z'));
$results = print_r($b, true); // $results agora contém a saída de print_r
?>

Veja Também

  • ob_start() - Ativa o buffer de saída
  • var_dump() - Mostra informações sobre a variável
  • var_export() - Mostra ou retorna uma representação estruturada de uma variável