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

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

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