print_r

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

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

Описание

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

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

print_r(), var_dump() и var_export() могут также показывать защищённые и закрытые атрибуты объектов. Статические элементы класса не будут отображены.

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

value: Выражение для вывода на экран.
return: Если вы хотите перехватить вывод print_r(), используйте параметр return. Если его значение равно true, то print_r() вернёт информацию вместо вывода в браузер.

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

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

Если параметр return установлен в true, данная функция вернёт строку (string). В противном случае возвращаемое значение будет равно true.

Примеры

Пример #1 Пример использования print_r()

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

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

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

Пример #2 Пример использования параметра return

<?php
$b = array ('m' => 'monkey', 'foo' => 'bar', 'x' => array ('x', 'y', 'z'));
$results = print_r($b, true); // $results теперь содержит вывод print_r
?>

Примечания

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

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

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