dumpvalue.html
来自「perl教程」· HTML 代码 · 共 271 行
HTML
271 行
<?xml version="1.0" ?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<!-- saved from url=(0017)http://localhost/ -->
<script language="JavaScript" src="../displayToc.js"></script>
<script language="JavaScript" src="../tocParas.js"></script>
<script language="JavaScript" src="../tocTab.js"></script>
<link rel="stylesheet" type="text/css" href="../scineplex.css">
<title>Dumpvalue - provides screen dump of Perl data.</title>
<link rel="stylesheet" href="../Active.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:" />
</head>
<body>
<script>writelinks('__top__',1);</script>
<h1><a>Dumpvalue - provides screen dump of Perl data.</a></h1>
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<ul>
<li><a href="#creation">Creation</a></li>
<li><a href="#methods">Methods</a></li>
</ul>
</ul>
<!-- INDEX END -->
<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>Dumpvalue - provides screen dump of Perl data.</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<pre>
<span class="keyword">use</span> <span class="variable">Dumpvalue</span><span class="operator">;</span>
<span class="keyword">my</span> <span class="variable">$dumper</span> <span class="operator">=</span> <span class="variable">new</span> <span class="variable">Dumpvalue</span><span class="operator">;</span>
<span class="variable">$dumper</span><span class="operator">-></span><span class="variable">set</span><span class="operator">(</span><span class="string">globPrint</span> <span class="operator">=></span> <span class="number">1</span><span class="operator">);</span>
<span class="variable">$dumper</span><span class="operator">-></span><span class="variable">dumpValue</span><span class="operator">(\</span><span class="variable">*::</span><span class="operator">);</span>
<span class="variable">$dumper</span><span class="operator">-></span><span class="variable">dumpvars</span><span class="operator">(</span><span class="string">'main'</span><span class="operator">);</span>
<span class="keyword">my</span> <span class="variable">$dump</span> <span class="operator">=</span> <span class="variable">$dumper</span><span class="operator">-></span><span class="variable">stringify</span><span class="operator">(</span><span class="variable">$some_value</span><span class="operator">);</span>
</pre>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>
</p>
<h2><a name="creation">Creation</a></h2>
<p>A new dumper is created by a call</p>
<pre>
$d = new Dumpvalue(option1 => value1, option2 => value2)</pre>
<p>Recognized options:</p>
<dl>
<dt><strong><a name="item_arraydepth_2c_hashdepth"><code>arrayDepth</code>, <code>hashDepth</code></a></strong>
<dd>
<p>Print only first N elements of arrays and hashes. If false, prints all the
elements.</p>
</dd>
</li>
<dt><strong><a name="item_compactdump_2c_verycompact"><a href="#item_compactdump"><code>compactDump</code></a>, <a href="#item_verycompact"><code>veryCompact</code></a></a></strong>
<dd>
<p>Change style of array and hash dump. If true, short array
may be printed on one line.</p>
</dd>
</li>
<dt><strong><a name="item_globprint"><code>globPrint</code></a></strong>
<dd>
<p>Whether to print contents of globs.</p>
</dd>
</li>
<dt><strong><a name="item_dumpdbfiles"><code>dumpDBFiles</code></a></strong>
<dd>
<p>Dump arrays holding contents of debugged files.</p>
</dd>
</li>
<dt><strong><a name="item_dumppackages"><code>dumpPackages</code></a></strong>
<dd>
<p>Dump symbol tables of packages.</p>
</dd>
</li>
<dt><strong><a name="item_dumpreused"><code>dumpReused</code></a></strong>
<dd>
<p>Dump contents of "reused" addresses.</p>
</dd>
</li>
<dt><strong><a name="item_tick_2c_quotehighbit_2c_printundef"><code>tick</code>, <a href="#item_quotehighbit"><code>quoteHighBit</code></a>, <code>printUndef</code></a></strong>
<dd>
<p>Change style of string dump. Default value of <code>tick</code> is <code>auto</code>, one
can enable either double-quotish dump, or single-quotish by setting it
to <code>"</code> or <code>'</code>. By default, characters with high bit set are printed
<em>as is</em>. If <a href="#item_quotehighbit"><code>quoteHighBit</code></a> is set, they will be quoted.</p>
</dd>
</li>
<dt><strong><a name="item_usageonly"><code>usageOnly</code></a></strong>
<dd>
<p>rudimentally per-package memory usage dump. If set,
<a href="#item_dumpvars"><code>dumpvars</code></a> calculates total size of strings in variables in the package.</p>
</dd>
</li>
<dt><strong><a name="item_unctrl">unctrl</a></strong>
<dd>
<p>Changes the style of printout of strings. Possible values are
<a href="#item_unctrl"><code>unctrl</code></a> and <code>quote</code>.</p>
</dd>
</li>
<dt><strong><a name="item_subdump">subdump</a></strong>
<dd>
<p>Whether to try to find the subroutine name given the reference.</p>
</dd>
</li>
<dt><strong><a name="item_barestringify">bareStringify</a></strong>
<dd>
<p>Whether to write the non-overloaded form of the stringify-overloaded objects.</p>
</dd>
</li>
<dt><strong><a name="item_quotehighbit">quoteHighBit</a></strong>
<dd>
<p>Whether to print chars with high bit set in binary or "as is".</p>
</dd>
</li>
<dt><strong><a name="item_stopdbsignal">stopDbSignal</a></strong>
<dd>
<p>Whether to abort printing if debugger signal flag is raised.</p>
</dd>
</li>
</dl>
<p>Later in the life of the object the methods may be queries with <a href="#item_get"><code>get()</code></a>
method and <a href="#item_set"><code>set()</code></a> method (which accept multiple arguments).</p>
<p>
</p>
<h2><a name="methods">Methods</a></h2>
<dl>
<dt><strong><a name="item_dumpvalue">dumpValue</a></strong>
<dd>
<pre>
<span class="variable">$dumper</span><span class="operator">-></span><span class="variable">dumpValue</span><span class="operator">(</span><span class="variable">$value</span><span class="operator">);</span>
<span class="variable">$dumper</span><span class="operator">-></span><span class="variable">dumpValue</span><span class="operator">(</span><span class="operator">[</span><span class="variable">$value1</span><span class="operator">,</span> <span class="variable">$value2</span><span class="operator">]</span><span class="operator">);</span>
</pre>
</dd>
<dd>
<p>Prints a dump to the currently selected filehandle.</p>
</dd>
<dt><strong><a name="item_dumpvalues">dumpValues</a></strong>
<dd>
<pre>
<span class="variable">$dumper</span><span class="operator">-></span><span class="variable">dumpValues</span><span class="operator">(</span><span class="variable">$value1</span><span class="operator">,</span> <span class="variable">$value2</span><span class="operator">);</span>
</pre>
</dd>
<dd>
<p>Same as <code> $dumper-</code>dumpValue([$value1, $value2]); >.</p>
</dd>
<dt><strong><a name="item_stringify">stringify</a></strong>
<dd>
<pre>
<span class="keyword">my</span> <span class="variable">$dump</span> <span class="operator">=</span> <span class="variable">$dumper</span><span class="operator">-></span><span class="variable">stringify</span><span class="operator">(</span><span class="variable">$value</span> <span class="operator">[</span><span class="operator">,</span><span class="variable">$noticks</span><span class="operator">]</span> <span class="operator">);</span>
</pre>
</dd>
<dd>
<p>Returns the dump of a single scalar without printing. If the second
argument is true, the return value does not contain enclosing ticks.
Does not handle data structures.</p>
</dd>
<dt><strong><a name="item_dumpvars">dumpvars</a></strong>
<dd>
<pre>
<span class="variable">$dumper</span><span class="operator">-></span><span class="variable">dumpvars</span><span class="operator">(</span><span class="string">'my_package'</span><span class="operator">);</span>
<span class="variable">$dumper</span><span class="operator">-></span><span class="variable">dumpvars</span><span class="operator">(</span><span class="string">'my_package'</span><span class="operator">,</span> <span class="string">'foo'</span><span class="operator">,</span> <span class="string">'~bar$'</span><span class="operator">,</span> <span class="string">'!......'</span><span class="operator">);</span>
</pre>
</dd>
<dd>
<p>The optional arguments are considered as literal strings unless they
start with <code>~</code> or <code>!</code>, in which case they are interpreted as regular
expressions (possibly negated).</p>
</dd>
<dd>
<p>The second example prints entries with names <code>foo</code>, and also entries
with names which ends on <code>bar</code>, or are shorter than 5 chars.</p>
</dd>
<dt><strong><a name="item_set_quote">set_quote</a></strong>
<dd>
<pre>
<span class="variable">$d</span><span class="operator">-></span><span class="variable">set_quote</span><span class="operator">(</span><span class="string">'"'</span><span class="operator">);</span>
</pre>
</dd>
<dd>
<p>Sets <code>tick</code> and <a href="#item_unctrl"><code>unctrl</code></a> options to suitable values for printout with the
given quote char. Possible values are <code>auto</code>, <code>'</code> and <code>"</code>.</p>
</dd>
<dt><strong><a name="item_set_unctrl">set_unctrl</a></strong>
<dd>
<pre>
<span class="variable">$d</span><span class="operator">-></span><span class="variable">set_unctrl</span><span class="operator">(</span><span class="string">'unctrl'</span><span class="operator">);</span>
</pre>
</dd>
<dd>
<p>Sets <a href="#item_unctrl"><code>unctrl</code></a> option with checking for an invalid argument.
Possible values are <a href="#item_unctrl"><code>unctrl</code></a> and <code>quote</code>.</p>
</dd>
<dt><strong><a name="item_compactdump">compactDump</a></strong>
<dd>
<pre>
<span class="variable">$d</span><span class="operator">-></span><span class="variable">compactDump</span><span class="operator">(</span><span class="number">1</span><span class="operator">);</span>
</pre>
</dd>
<dd>
<p>Sets <a href="#item_compactdump"><code>compactDump</code></a> option. If the value is 1, sets to a reasonable
big number.</p>
</dd>
<dt><strong><a name="item_verycompact">veryCompact</a></strong>
<dd>
<pre>
<span class="variable">$d</span><span class="operator">-></span><span class="variable">veryCompact</span><span class="operator">(</span><span class="number">1</span><span class="operator">);</span>
</pre>
</dd>
<dd>
<p>Sets <a href="#item_compactdump"><code>compactDump</code></a> and <a href="#item_verycompact"><code>veryCompact</code></a> options simultaneously.</p>
</dd>
<dt><strong><a name="item_set">set</a></strong>
<dd>
<pre>
<span class="variable">$d</span><span class="operator">-></span><span class="variable">set</span><span class="operator">(</span><span class="string">option1</span> <span class="operator">=></span> <span class="variable">value1</span><span class="operator">,</span> <span class="string">option2</span> <span class="operator">=></span> <span class="variable">value2</span><span class="operator">);</span>
</pre>
</dd>
<dt><strong><a name="item_get">get</a></strong>
<dd>
<pre>
<span class="variable">@values</span> <span class="operator">=</span> <span class="variable">$d</span><span class="operator">-></span><span class="variable">get</span><span class="operator">(</span><span class="string">'option1'</span><span class="operator">,</span> <span class="string">'option2'</span><span class="operator">);</span>
</pre>
</dd>
</dl>
</body>
</html>
⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?