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

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

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