📄 ch08_200.htm

📁 by Randal L. Schwartz and Tom Phoenix ISBN 0-596-00132-0 Third Edition, published July 2001. (See
💻 HTM
字号:
<html><head><title>Test::Builder (Perl in a Nutshell, 2nd Edition)</title><link rel="stylesheet" type="text/css" href="../style/style1.css" /><meta name="DC.Creator" content="Stephen Spainhour" /><meta name="DC.Format" content="text/xml" scheme="MIME" /><meta name="DC.Language" content="en-US" /><meta name="DC.Publisher" content="O'Reilly &amp; Associates, Inc." /><meta name="DC.Source" scheme="ISBN" content="0596002416L" /><meta name="DC.Subject.Keyword" content="stuff" /><meta name="DC.Title" content="Perl in a Nutshell, 2nd Edition" /><meta name="DC.Type" content="Text.Monograph" /></head><body bgcolor="#ffffff"><img src="gifs/smbanner.gif" usemap="#banner-map" border="0" alt="Book Home" /><map name="banner-map"><area shape="rect" coords="1,-2,616,66" href="index.htm" alt="Java and XSLT" /><area shape="rect" coords="629,-11,726,25" href="jobjects/fsearch.htm" alt="Search this book" /></map><div class="navbar"><table width="684" border="0"><tr><td align="left" valign="top" width="228"><a href="ch08_199.htm"><img src="../gifs/txtpreva.gif" alt="Previous" border="0" /></a></td><td align="center" valign="top" width="228" /><td align="right" valign="top" width="228"><a href="ch08_201.htm"><img src="../gifs/txtnexta.gif" alt="Next" border="0" /></a></td></tr></table></div><h2 class="sect1">8.200. Test::Builder</h2><p><a name="INDEX-1564" />A backend for building test librariesunder Perl. Note that Test::Builder is in the early stages ofdevelopment and that things may become more (or less) stable, or maychange completely. Test::Builder is more flexible than other testingmodules such as Test::Simple and Test::More.</p><p>Test::Builder implements the following methods.</p><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>new</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>new()</pre><p>Returns a Test::Builder object representing the current state of thetest. There's no need to create more than oneTest::Builder object, since you run only one test per program.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>BAILOUT</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>BAILOUT(<em class="replaceable">reason</em>)</pre><p>Terminates all tests and exits immediately.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>expected_tests</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>expected_tests()</pre><p>Gets and sets the tests that will run and prints out the correctheaders.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>exported_to</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>exported_to(<em class="replaceable">package</em>)</pre><p>Specifies the package you exported your functions to.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>is_eq</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>is_eq(<em class="replaceable">got_from_test</em>, <em class="replaceable">expected_from_test</em>, <em class="replaceable">name_of_test</em>)</pre><p>Checks if <em class="replaceable">got_from_test</em><tt class="literal">eq</tt> <em class="replaceable">expected_from_test</em>.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>isnt_eq</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>isnt_eq(<em class="replaceable">got_from_test</em>, <em class="replaceable">did_not_expect</em>, <em class="replaceable">name_of_test</em>)</pre><p>Checks if <em class="replaceable">got_from_test</em><tt class="literal">ne</tt> <em class="replaceable">did_not_expect</em>.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>isnt_num</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>isnt_num(<em class="replaceable">got_from_test</em>, <em class="replaceable">did_not_expect</em>, <em class="replaceable">name_of_test</em>)</pre><p>Checks if <em class="replaceable">got_from_test</em><tt class="literal">!=</tt> <em class="replaceable">did_not_expect</em>.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>is_num</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>is_num(<em class="replaceable">got_from_test</em>, <em class="replaceable">expected_from_test</em>, <em class="replaceable">name_of_test</em>)</pre><p>Checks if <em class="replaceable">got_from_test</em><tt class="literal">==</tt> <em class="replaceable">expected_from_test</em>.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>like </b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>like(<em class="replaceable">string</em>, <tt class="literal">'/</tt><em class="replaceable">regex</em><tt class="literal">/'</tt>, <em class="replaceable">name_of_test</em>)</pre><p>Checks if <em class="replaceable">string</em> matches the specifiedregular expression.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>no_plan</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>no_plan()</pre><p>Declares that there may be an infinite number of tests.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>ok</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>ok(<em class="replaceable">test</em>, <em class="replaceable">name</em>)</pre><p>Reports if <em class="replaceable">test</em> by<em class="replaceable"><tt>name</tt></em> is true.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>plan</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>plan()</pre><p>Sets up the tests for you, prints appropriate headers, and takesappropriate actions. <tt class="literal">plan</tt> can be used in lieu ofany of the subsequent methods.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>skip</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>skip([<em class="replaceable">reason</em>])</pre><p>Skips the current test, citing <em class="replaceable">reason</em>.</p></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>skip_all</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>skip_all(<em class="replaceable">reason</em>)</pre><p>Shamelessly skips all the tests, citing the given <em class="replaceable">reason</em> . Exits with <tt class="literal">0</tt>.</p><blockquote><pre class="code">my $reason = "I didn't feel like it today.";$Test-&gt;skip_all($reason);</pre></blockquote></div><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>unlike</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>unlike(<em class="replaceable">string</em>, <tt class="literal">'/</tt><em class="replaceable">regex</em><tt class="literal">/'</tt>, <em class="replaceable">name_of_test</em>)</pre><p>Checks if <em class="replaceable">string</em> does not match thespecified regular expression.</p></div><hr width="684" align="left" /><div class="navbar"><table width="684" border="0"><tr><td align="left" valign="top" width="228"><a href="ch08_199.htm"><img src="../gifs/txtpreva.gif" alt="Previous" border="0" /></a></td><td align="center" valign="top" width="228"><a href="index.htm"><img src="../gifs/txthome.gif" alt="Home" border="0" /></a></td><td align="right" valign="top" width="228"><a href="ch08_201.htm"><img src="../gifs/txtnexta.gif" alt="Next" border="0" /></a></td></tr><tr><td align="left" valign="top" width="228">8.199. Test</td><td align="center" valign="top" width="228"><a href="index/index.htm"><img src="../gifs/index.gif" alt="Book Index" border="0" /></a></td><td align="right" valign="top" width="228">8.201. Test::Harness</td></tr></table></div><hr width="684" align="left" /><img src="../gifs/navbar.gif" usemap="#library-map" border="0" alt="Library Navigation Links" /><p><p><font size="-1"><a href="copyrght.htm">Copyright &copy; 2002</a> O'Reilly &amp; Associates. All rights reserved.</font></p><map name="library-map"><area shape="rect" coords="1,0,85,94" href="../index.htm"><area shape="rect" coords="86,1,178,103" href="../lwp/index.htm"><area shape="rect" coords="180,0,265,103" href="../lperl/index.htm"><area shape="rect" coords="267,0,353,105" href="../perlnut/index.htm"><area shape="rect" coords="354,1,446,115" href="../prog/index.htm"><area shape="rect" coords="448,0,526,132" href="../tk/index.htm"><area shape="rect" coords="528,1,615,119" href="../cookbook/index.htm"><area shape="rect" coords="617,0,690,135" href="../pxml/index.htm"></map></body></html>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -