📄 ch10_07.htm
字号:
<html><head><title>CGI.pm Reference (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 & 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="ch10_06.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="ch11_01.htm"><img src="../gifs/txtnexta.gif" alt="Next" border="0" /></a></td></tr></table></div><h2 class="sect1">10.7. CGI.pm Reference</h2><p>The following methods are supported by CGI.pm.</p><a name="INDEX-1667" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>accept</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>$<em class="replaceable">query</em>->accept(['<em class="replaceable">content_type</em>'])</pre><p><a name="INDEX-1667" />Returns a list of media types that thebrowser accepts.</p><dl><dt><i><em class="replaceable"><tt>content_type</tt></em></i></dt><dd>If specified, returns instead the browser'spreference for the specified content type, between 0.0 and 1.0</p></dd></dl></div><a name="INDEX-1668" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>append</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre><tt class="literal">$</tt><em class="replaceable">query</em>->append(-name=>'<em class="replaceable">name</em>',-values=>'<em class="replaceable">value</em>')</pre><p><a name="INDEX-1668" />Appends a value or list of values tothe named parameter.</p><dl><dt><b><tt class="literal">-name=>'</tt><em class="replaceable">name</em><tt class="literal">'</tt></b></dt><dd>The parameter to append.</p></dd><dt><b><tt class="literal">-values=>'</tt><em class="replaceable">value</em><tt class="literal">'</tt></b></dt><dd>The value to append. Multiple values can be specified as a referenceto an anonymous array.</p></dd></dl></div><a name="INDEX-1669" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>auth_type</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>auth_type( )</pre><p><a name="INDEX-1669" />Returns the authorization method.</p></div><a name="INDEX-1670" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>autoEscape</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre><tt class="literal">$</tt><em class="replaceable">query</em>->autoEscape(undef)</pre><p><a name="INDEX-1670" />Turns off autoescaping of formelements.</p></div><a name="INDEX-1671" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>button</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>print <tt class="literal">$</tt><em class="replaceable">query</em>->button('<em class="replaceable">name</em>','<em class="replaceable">function</em>')</pre><p><a name="INDEX-1671" />Generates a JavaScript button.</p><dl><dt><i><em class="replaceable"><tt>name</tt></em></i></dt><dd>The name of the button.</p></dd><dt><i><em class="replaceable"><tt>function</tt></em></i></dt><dd>The function to execute when the button is clicked. Using namedparameters, the syntax is:</p><blockquote><pre class="code">print $query->button(-name=>'<em class="replaceable"><tt>name</tt></em>', -value=>'<em class="replaceable"><tt>label</tt></em>', -onClick=>"<em class="replaceable"><tt>function</tt></em>");</pre></blockquote><dl><dt><b><tt class="literal">-value=>'</tt><em class="replaceable">label</em><tt class="literal">'</tt> </b></dt><dd>The label to display for the button</p></dd></dl></dd></dl></div><a name="INDEX-1672" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>checkbox</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>print <tt class="literal">$</tt><em class="replaceable">query</em>->checkbox('<em class="replaceable">name</em>' [,'<em class="replaceable">checked</em>','<em class="replaceable">value</em>','<em class="replaceable">label</em>'])</pre><p><a name="INDEX-1672" />Generates a single checkbox.</p><dl><dt><i><em class="replaceable"><tt>name</tt></em></i></dt><dd>The name to assign the input to (required).</p></dd><dt><i><em class="replaceable"><tt>checked</tt></em></i></dt><dd>Checkbox should be checked initially.</p></dd><dt><i><em class="replaceable"><tt>value</tt></em></i></dt><dd>The value to return when checked (default is <tt class="literal">on</tt>).</p></dd><dt><i><em class="replaceable"><tt>label</tt></em></i></dt><dd>The label to use for the checkbox (default is the name of thecheckbox). Using named parameters, the syntax is:</p><blockquote><pre class="code">print $query->checkbox(-name=>'<em class="replaceable"><tt>name</tt></em>', -checked=>'<em class="replaceable"><tt>checked</tt></em>', -value=>'<em class="replaceable"><tt>value</tt></em>', -label=>'<em class="replaceable"><tt>label</tt></em>', -onClick=><em class="replaceable"><tt>function</tt></em>);</pre></blockquote><dl><dt><b><tt class="literal">-onClick=></tt><em class="replaceable">function</em></b></dt><dd>Browser should execute <em class="replaceable"><tt>function</tt></em> when theuser clicks on any checkbox in the group</p></dd></dl></dd></dl></div><a name="INDEX-1673" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>checkbox_group</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>print <tt class="literal">$</tt><em class="replaceable">query</em>->checkbox_group('<em class="replaceable">name</em>', \@<em class="replaceable">list</em> [, <em class="replaceable">selected</em>,'true',\%<em class="replaceable">labelhash</em> ])</pre><p><a name="INDEX-1673" />Generates a list of checkbox elements.</p><dl><dt><i><em class="replaceable"><tt>name</tt></em></i></dt><dd>The name to assign the input to (required).</p></dd><dt><b><tt class="literal">\@</tt><em class="replaceable">list</em></b></dt><dd>An array reference with the list items. You can also use an anonymousarray reference.</p></dd><dt><i><em class="replaceable"><tt>selected</tt></em></i></dt><dd>The menu item(s) to be initially selected (default is that nothing isselected). This can be a single value or a reference to an array ofvalues.</p></dd><dt><b><tt class="literal">'true'</tt></b></dt><dd>Insert newlines between the checkboxes.</p></dd><dt><b><tt class="literal">\%</tt><em class="replaceable">labelhash</em></b></dt><dd>A hash reference listing labels for each list item. Default is thelist text itself. See <tt class="literal">popup_menu</tt> for an example.Using named parameters, the syntax is:</p><blockquote><pre class="code">print $query->checkbox_group(-name=>'<em class="replaceable"><tt>name</tt></em>', -values=>\<em class="replaceable"><tt>@list</tt></em>, -default=><em class="replaceable"><tt>selected</tt></em>, -linebreak=>'true', -labels=>\%<em class="replaceable"><tt>labelhash</tt></em>, -columns=><em class="replaceable"><tt>n</tt></em>, -columnheader=>'<em class="replaceable"><tt>string</tt></em>', -rows=><em class="replaceable"><tt>m</tt></em>, -rowheader=>'<em class="replaceable"><tt>string</tt></em>', -onClick=><em class="replaceable"><tt>function</tt></em>);</pre></blockquote><dl><dt><b><tt class="literal">-columns=></tt><em class="replaceable">n</em></b></dt><dd>The number of columns to use.</p></dd><dt><b><tt class="literal">-columnheader=>'</tt><em class="replaceable">string</em><tt class="literal">'</tt></b></dt><dd>A header for the column.</p></dd><dt><b><tt class="literal">-rows=</tt><em class="replaceable">m</em></b></dt><dd>The number of rows to use. If omitted, and<tt class="literal">-columns</tt> is specified, the rows will be calculatedfor you.</p></dd><dt><b><tt class="literal">-rowheader=>'</tt><em class="replaceable">string</em><tt class="literal">'</tt></b></dt><dd>A header for the row.</p></dd><dt><b><tt class="literal">-onClick=></tt><em class="replaceable">function</em></b></dt><dd>Browser should execute <em class="replaceable"><tt>function</tt></em> when theuser clicks on any checkbox in the group.</p></dd></dl></dd></dl></div><a name="INDEX-1674" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>cookie</b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre><tt class="literal">$</tt><em class="replaceable">cookie</em>=$<em class="replaceable">query</em>->cookie('<em class="replaceable">name</em>')</pre><p><a name="INDEX-1674" />Defines or retrieves a cookie. See also<tt class="literal">header</tt>.</p><dl><dt><i><em class="replaceable"><tt>name</tt></em></i></dt><dd>Name of the cookie (required). Using named parameters, the syntax is: </p><blockquote><pre class="code">$cookie = $query->cookie(-name=>'<em class="replaceable"><tt>name</tt></em>', -value=>'<em class="replaceable"><tt>value</tt></em>', -expires=>'<em class="replaceable"><tt>expcode</tt></em>', -path=>'<em class="replaceable"><tt>partial_url</tt></em>', -domain=>'<em class="replaceable"><tt>domain_name</tt></em>', -secure=>1);print $query->header(-cookie=>$cookie);</pre></blockquote><dl><dt><b><tt class="literal">-value=>'</tt><em class="replaceable">value</em><tt class="literal">'</tt></b></dt><dd>A value to assign to the cookie. You can supply a scalar value, or areference to an array or hash. If omitted, a cookie will be retrievedrather than defined.</p></dd><dt><b><tt class="literal">-expires=></tt><em class="replaceable">expcode</em></b></dt><dd>Specifies an expiration timestamp (such as <tt class="literal">+3d</tt> forthree days). Values for <em class="replaceable"><tt>expcode</tt></em> are:</p><dl><dt><i><em class="replaceable"><tt>n</tt></em><tt class="literal">s</tt></i></dt><dd><em class="replaceable"><tt>n</tt></em> seconds</p></dd><dt><i><em class="replaceable"><tt>n</tt></em><tt class="literal">m</tt></i></dt><dd><em class="replaceable"><tt>n</tt></em> minutes</p></dd><dt><i><em class="replaceable"><tt>n</tt></em><tt class="literal">h</tt></i></dt><dd><em class="replaceable"><tt>n</tt></em> hours</p></dd><dt><i><em class="replaceable"><tt>n</tt></em><tt class="literal">d</tt></i></dt><dd><em class="replaceable"><tt>n</tt></em> days</p></dd><dt><i><em class="replaceable"><tt>n</tt></em><tt class="literal">M</tt></i></dt><dd><em class="replaceable"><tt>n</tt></em> months</p></dd><dt><i><em class="replaceable"><tt>n</tt></em><tt class="literal">y</tt></i></dt><dd><em class="replaceable"><tt>n</tt></em> years</p></dd><dt><i><em class="replaceable"><tt>day_of_week</em>, <em class="replaceable">dd</em>-<em class="replaceable">MMM</em>-<em class="replaceable">YY hh:mm:ss</tt></em> <tt class="literal">GMT</tt> </i></dt><dd>At the specified time.</p></dd><dt><b><tt class="literal">now</tt></b></dt><dd>Expires immediately.</p></dd></dl></dd><dt><b><tt class="literal">-path=>'</tt><em class="replaceable">partial_url</em><span class="option">'</span></b></dt><dd>The partial URL for which the cookie is valid. Default is the currentURL.</p></dd>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -