Dumpvalue

СОДЕРЖАНИЕ

• НАЗВАНИЕ
• СИНТАКСИС
• ОПИСАНИЕ
  • Создание
  • Методы

НАЗВАНИЕ

Dumpvalue — предоставляет дамп содержимого данных Perl на экран.

СИНТАКСИС

use Dumpvalue;
my $dumper = Dumpvalue->new;
$dumper->set(globPrint => 1);
$dumper->dumpValue(\*::);
$dumper->dumpvars('main');
my $dump = $dumper->stringify($some_value);

ОПИСАНИЕ

Создание

Новый дампер создается вызовом

$d = Dumpvalue->new(option1 => value1, option2 => value2)

Распознаваемые опции:

arrayDepth, hashDepth

Выводит только первые N элементов массивов и хешей. Если false, выводит все элементы.

compactDump, veryCompact

Изменяет стиль вывода массивов и хешей. Если true, короткие массивы могут быть выведены в одну строку.

globPrint

Выводить ли содержимое глобов.

dumpDBFiles

Выводить массивы, содержащие содержимое отлаживаемых файлов.

dumpPackages

Выводить таблицы символов пакетов.

dumpReused

Выводить содержимое «переиспользуемых» адресов.

tick, quoteHighBit, printUndef

Изменяет стиль вывода строк. Значение по умолчанию tick равно auto, можно включить вывод в двойных кавычках или одинарных, установив его соответственно в " или '. По умолчанию символы с установленным старшим битом выводятся как есть. Если quoteHighBit установлено, они будут заключены в кавычки.

usageOnly

Примитивный дамп использования памяти по пакетам. Если установлено, dumpvars рассчитывает общий размер строк в переменных в пакете.

unctrl

Изменяет стиль вывода строк. Возможные значения — unctrl и quote.

subdump

Пытаться ли найти имя подпрограммы, зная ссылку.

bareStringify

Выводить ли неуперегруженную форму строк для объектов, перегружающих stringify.

quoteHighBit

Выводить ли символы с установленным старшим битом в двоичном формате или «как есть».

stopDbSignal

Прерывать ли вывод, если поднят флаг сигнала отладчика.

Позже в жизни объекта методы могут быть запрошены с помощью методов get() и set() (которые принимают несколько аргументов).

Методы

dumpValue

$dumper->dumpValue($value);
$dumper->dumpValue([$value1, $value2]);

Выводит дамп в текущий выбранный файловый дескриптор.

dumpValues

$dumper->dumpValues($value1, $value2);

То же, что и $dumper->dumpValue([$value1, $value2]);.

stringify

my $dump = $dumper->stringify($value [,$noticks] );

Возвращает дамп одного скаляра без вывода на экран. Если второй аргумент истина, возвращаемое значение не содержит окружающие апострофы. Не обрабатывает структуры данных.

dumpvars

$dumper->dumpvars('my_package');
$dumper->dumpvars('my_package', 'foo', '~bar$', '!......');

Дополнительные аргументы рассматриваются как строковые литералы, если они не начинаются с ~ или !, в этом случае они интерпретируются как регулярные выражения (возможно, с отрицанием).

Второй пример выводит записи с именами foo, а также записи с именами, оканчивающимися на bar, или именами короче 5 символов.

set_quote

$d->set_quote('"');

Устанавливает опции tick и unctrl на подходящие значения для вывода с заданным символом кавычек. Возможные значения — auto, ' и ".

set_unctrl

$d->set_unctrl('unctrl');

Устанавливает опцию unctrl с проверкой на некорректный аргумент. Возможные значения — unctrl и quote.

compactDump

$d->compactDump(1);

Устанавливает опцию compactDump. Если значение равно 1, устанавливает в разумно большое число.

veryCompact

$d->veryCompact(1);

Устанавливает опции compactDump и veryCompact одновременно.

set

$d->set(option1 => value1, option2 => value2);

get

@values = $d->get('option1', 'option2');