print_r

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

print_r Exibe informação legível sobre uma variável

Descrição

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

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.

Parâmetros

value

A 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.

Valor Retornado

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.

Exemplos

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

Notas

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

Veja Também

  • ob_start() - Ativa o buffer de saída
  • var_dump() - Despeja na saída informações sobre uma variável
  • var_export() - Mostra ou retorna uma representação string analisável de uma variável
To Top