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' => 'яблоко', '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
?>

Примечания

Замечание:

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

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

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