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 элементов массивов и хешей. Если ложно, выводит все элементы.

compactDump, veryCompact

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

globPrint

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

dumpDBFiles

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

dumpPackages

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

dumpReused

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

tick, quoteHighBit, printUndef

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

usageOnly

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

unctrl

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

subdump

Попытка найти имя подпрограммы по ссылке.

bareStringify

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

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');