內容

名稱
語法
說明
- 建立
- 方法

#名稱

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: 是否列印 glob 的內容。
#dumpDBFiles: 傾印包含已偵錯檔案內容的陣列。
#dumpPackages: 傾印套件的符號表。
#dumpReused: 傾印「重複使用」位址的內容。
#tick, quoteHighBit, printUndef: 變更字串傾印的樣式。tick 的預設值為 auto，可以透過將其設定為 " 或 ' 來啟用雙引號傾印或單引號傾印。預設情況下，會將設定了高位元組的字元「原樣」列印。如果設定了 quoteHighBit，則會將它們加上引號。
#usageOnly: 每個套件的基礎記憶體使用量傾印。如果設定為 true，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');