(PHP 4, PHP 5, PHP 7, PHP 8)
print_r — Exibe informação legível sobre uma variável
print_r() exibe informação sobre uma variável de uma forma legível para humanos.
print_r(), var_dump() e var_export() mostrarão também propriedades protegidas e privadas de objetos. Membros de classes estáticas não serão mostrados.
valueA expressão a ser exibida.
return
Se for desejado capturar a saída de print_r(),
utilize o parâmetro return. Quando esse parâmetro for definido
para true, print_r() retornará a informação, ao invés de exibi-la.
Se for fornecido uma string, um int ou um float, o próprio valor será impresso. Se for fornecido um array, valores serão apresentados em um formato que mostra chaves e elementos. Notação similar é utilizada para objetos (objects).
Quando o parâmetro return for true, esta função
retornará uma string. Caso contrário, o valor retornado será true.
| Versão | Descrição |
|---|---|
| 8.4.0 | O tipo de retorno foi alterado de string|bool para string|true. |
Exemplo #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 produzirá:
<pre>
Array
(
[a] => apple
[b] => banana
[c] => Array
(
[0] => x
[1] => y
[2] => z
)
)
</pre>
Exemplo #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
print_r($results);
?>Nota:
Quando o parâmetro
returné usado, esta função usa um buffer de saída interno antes do PHP 7.1.0, portanto não pode ser usada em uma função callback da função ob_start().