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