print_r

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

print_r Выводит удобную для чтения человеком информацию о переменной

Описание

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

Функция print_r() выводит информацию о переменной в удобном для чтения виде.

Функции print_r(), var_dump() и var_export() показывают также защищённые и закрытые свойства объектов. Статические члены класса не отображаются.

Список параметров

value

Выражение для вывода.

return

Вывод функции print_r() перехватывают путём установки параметра return. Со значением true функция print_r() вернёт информацию, а не выведет.

Возвращаемые значения

При передаче в функцию значений с типами string, int или float выводится само значение. При передаче массива (array) значения выводятся в формате, который показывает ключи и элементы массива. Аналогичный формат вывода применяется для объектов.

При установке для параметра return значения true функция возвращает значение с типом string, иначе возвращает значение true.

Список изменений

Версия Описание
8.4.0 Тип возврата изменили со string|bool на string|true.

Примеры

Пример #1 Пример вывода информации о переменной функцией print_r()

<pre>
<?php

$a
= array('a' => 'яблоко', 'b' => 'банан', 'c' => array('x', 'y', 'z'));
print_r($a);

?>
</pre>

Результат выполнения приведённого примера:

<pre>
Array
(
    [a] => яблоко
    [b] => банан
    [c] => Array
        (
            [0] => x
            [1] => y
            [2] => z
        )
)
</pre>

Пример #2 Пример поведения параметра return

<?php

$b
= array ('m' => 'обезьяна', 'foo' => 'bar', 'x' => array('x', 'y', 'z'));
$results = print_r($b, true); // Переменная $results теперь содержит вывод функции print_r

print_r($results);

?>

Примечания

Замечание:

Функцию нельзя вызывать внутри callback-функции, которую указали в первом аргументе функции ob_start(), поскольку когда параметр return настраивают для возврата, а не вывода значения, функция использует внутреннюю буферизацию вывода до PHP 7.1.0.

Смотрите также

  • ob_start() - Включает буферизацию вывода
  • var_dump() - Выводит информацию о переменной
  • var_export() - Выводит или возвращает удобное для разбора строковое представление переменной