internet.html

来自「perl教程」· HTML 代码 · 共 1,063 行 · 第 1/5 页

<dt><strong><a name="item_combineurl_baseurl_2c_relativeurl_2c__5bflags_5d">CombineURL baseURL, relativeURL, [flags]</a></strong>

<dd>
<p>Combines a base and relative URL into a single URL.  Returns the
(canonicalized) combined URL or <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors.  For the possible
values of <em>flags</em>, refer to the <a href="#microsoft_win32_internet_functions">Microsoft Win32 Internet Functions</a> document.  See also <code>CombineURL</code> and <code>OpenURL</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
    <span class="variable">$URL</span> <span class="operator">=</span> <span class="variable">$INET</span><span class="operator">-&gt;</span><span class="variable">CombineURL</span><span class="operator">(</span><span class="string">"http://www.divinf.it/dada/perl/internet"</span><span class="operator">,</span> <span class="string">".."</span><span class="operator">);</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_connectbackoff__5bvalue_5d">ConnectBackoff [value]</a></strong>

<dd>
<p>Reads or sets the delay value, in milliseconds, to wait between
connection retries.  If no <em>value</em> parameter is specified, the
current value is returned; otherwise, the delay between retries is set
to <em>value</em>.  See also <code>ConnectTimeout</code>, <code>ConnectRetries</code>,
<code>QueryOption</code> and <code>SetOption</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
    <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ConnectBackoff</span><span class="operator">(</span><span class="number">2000</span><span class="operator">);</span>
    <span class="variable">$backoff</span> <span class="operator">=</span> <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ConnectBackoff</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_connectretries__5bvalue_5d">ConnectRetries [value]</a></strong>

<dd>
<p>Reads or sets the number of times a connection is retried before
considering it failed.  If no <em>value</em> parameter is specified, the
current value is returned; otherwise, the number of retries is set to
<em>value</em>.  The default value for <code>ConnectRetries</code> is 5.  See also
<code>ConnectBackoff</code>, <code>ConnectTimeout</code>, <code>QueryOption</code> and <code>SetOption</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
    <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ConnectRetries</span><span class="operator">(</span><span class="number">20</span><span class="operator">);</span>
    <span class="variable">$retries</span> <span class="operator">=</span> <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ConnectRetries</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_connecttimeout__5bvalue_5d">ConnectTimeout [value]</a></strong>

<dd>
<p>Reads or sets the timeout value (in milliseconds) before a connection
is considered failed.  If no <em>value</em> parameter is specified, the
current value is returned; otherwise, the timeout is set to <em>value</em>.
The default value for <code>ConnectTimeout</code> is infinite.  See also
<code>ConnectBackoff</code>, <code>ConnectRetries</code>, <code>QueryOption</code> and <code>SetOption</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
    <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ConnectTimeout</span><span class="operator">(</span><span class="number">10000</span><span class="operator">);</span>
    <span class="variable">$timeout</span> <span class="operator">=</span> <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ConnectTimeout</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_controlreceivetimeout__5bvalue_5d">ControlReceiveTimeout [value]</a></strong>

<dd>
<p>Reads or sets the timeout value (in milliseconds) to use for non-data
(control) receive requests before they are canceled.  Currently, this
value has meaning only for <code>FTP</code> sessions.  If no <em>value</em> parameter
is specified, the current value is returned; otherwise, the timeout is
set to <em>value</em>.  The default value for <code>ControlReceiveTimeout</code> is
infinite.  See also <code>ControlSendTimeout</code>, <code>QueryOption</code> and
<code>SetOption</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
    <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ControlReceiveTimeout</span><span class="operator">(</span><span class="number">10000</span><span class="operator">);</span>
    <span class="variable">$timeout</span> <span class="operator">=</span> <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ControlReceiveTimeout</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_controlsendtimeout__5bvalue_5d">ControlSendTimeout [value]</a></strong>

<dd>
<p>Reads or sets the timeout value (in milliseconds) to use for non-data
(control) send requests before they are canceled.  Currently, this
value has meaning only for <code>FTP</code> sessions.  If no <em>value</em> parameter
is specified, the current value is returned; otherwise, the timeout is
set to <em>value</em>.  The default value for <code>ControlSendTimeout</code> is
infinite.  See also <code>ControlReceiveTimeout</code>, <code>QueryOption</code> and
<code>SetOption</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
    <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ControlSendTimeout</span><span class="operator">(</span><span class="number">10000</span><span class="operator">);</span>
    <span class="variable">$timeout</span> <span class="operator">=</span> <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">ControlSendTimeout</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_crackurl_url_2c__5bflags_5d">CrackURL URL, [flags]</a></strong>

<dd>
<p>Splits an URL into its component parts and returns them in an array.
Returns <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors, otherwise the array will contain the
following values: <em>scheme, host, port, username, password, path,
extrainfo</em>.</p>
</dd>
<dd>
<p>For example, the URL &quot;http://www.divinf.it/index.html#top&quot; can be
splitted in:</p>
</dd>
<dd>
<pre>
    http, www.divinf.it, 80, anonymous, [e-mail], /index.html, #top</pre>
</dd>
<dd>
<p>If you don't specify a <em>flags</em> parameter, ICU_ESCAPE will be used by
default; for the possible values of <em>flags</em> refer to the <a href="#microsoft_win32_internet_functions">Microsoft Win32 Internet Functions</a> documentation.  See also <code>CreateURL</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
    <span class="variable">@parts</span><span class="operator">=</span><span class="variable">$INET</span><span class="operator">-&gt;</span><span class="variable">CrackURL</span><span class="operator">(</span><span class="string">"http://www.activeware.com"</span><span class="operator">);</span>
    <span class="operator">(</span><span class="variable">$scheme</span><span class="operator">,</span> <span class="variable">$host</span><span class="operator">,</span> <span class="variable">$port</span><span class="operator">,</span> <span class="variable">$user</span><span class="operator">,</span> <span class="variable">$pass</span><span class="operator">,</span> <span class="variable">$path</span><span class="operator">,</span> <span class="variable">$extra</span><span class="operator">)</span> <span class="operator">=</span>
         <span class="variable">$INET</span><span class="operator">-&gt;</span><span class="variable">CrackURL</span><span class="operator">(</span><span class="string">"http://www.divinf.it:80/perl-win32/index.sht#feedback"</span><span class="operator">);</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_createurl_scheme_2c_hostname_2c_port_2c_username_2">CreateURL scheme, hostname, port, username, password, path, extrainfo, [flags]</a></strong>

<dt><strong><a name="item_createurl_hashref_2c__5bflags_5d">CreateURL hashref, [flags]</a></strong>

<dd>
<p>Creates a URL from its component parts.  Returns <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors,
otherwise the created URL.</p>
</dd>
<dd>
<p>If you pass <em>hashref</em> (a reference to an hash array), the following
values are taken from the array:</p>
</dd>
<dd>
<pre>
    <span class="variable">%hash</span><span class="operator">=(</span>
      <span class="string">"scheme"</span>    <span class="operator">=&gt;</span> <span class="string">"scheme"</span><span class="operator">,</span>
      <span class="string">"hostname"</span>  <span class="operator">=&gt;</span> <span class="string">"hostname"</span><span class="operator">,</span>
      <span class="string">"port"</span>      <span class="operator">=&gt;</span> <span class="variable">port</span><span class="operator">,</span>
      <span class="string">"username"</span>  <span class="operator">=&gt;</span> <span class="string">"username"</span><span class="operator">,</span>
      <span class="string">"password"</span>  <span class="operator">=&gt;</span> <span class="string">"password"</span><span class="operator">,</span>
      <span class="string">"path"</span>      <span class="operator">=&gt;</span> <span class="string">"path"</span><span class="operator">,</span>
      <span class="string">"extrainfo"</span> <span class="operator">=&gt;</span> <span class="string">"extrainfo"</span><span class="operator">,</span>
    <span class="operator">);</span>
</pre>
</dd>
<dd>
<p>If you don't specify a <em>flags</em> parameter, ICU_ESCAPE will be used by
default; for the other possible values of <em>flags</em> refer to the
<a href="#microsoft_win32_internet_functions">Microsoft Win32 Internet Functions</a> documentation.  See also
<code>CrackURL</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
    <span class="variable">$URL</span><span class="operator">=</span><span class="variable">$I</span><span class="operator">-&gt;</span><span class="variable">CreateURL</span><span class="operator">(</span><span class="string">"http"</span><span class="operator">,</span> <span class="string">"www.divinf.it"</span><span class="operator">,</span> <span class="number">80</span><span class="operator">,</span> <span class="string">""</span><span class="operator">,</span> <span class="string">""</span><span class="operator">,</span> <span class="string">"/perl-win32/index.sht"</span><span class="operator">,</span> <span class="string">"#feedback"</span><span class="operator">);</span>
    <span class="variable">$URL</span><span class="operator">=</span><span class="variable">$I</span><span class="operator">-&gt;</span><span class="variable">CreateURL</span><span class="operator">(\</span><span class="variable">%params</span><span class="operator">);</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_datareceivetimeout__5bvalue_5d">DataReceiveTimeout [value]</a></strong>

<dd>
<p>Reads or sets the timeout value (in milliseconds) to use for data
receive requests before they are canceled.  If no <em>value</em> parameter
is specified, the current value is returned; otherwise, the timeout is
set to <em>value</em>.  The default value for DataReceiveTimeout is
infinite.  See also <code>DataSendTimeout</code>, <code>QueryOption</code> and
<code>SetOption</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
    <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">DataReceiveTimeout</span><span class="operator">(</span><span class="number">10000</span><span class="operator">);</span>
    <span class="variable">$timeout</span> <span class="operator">=</span> <span class="variable">$HTTP</span><span class="operator">-&gt;</span><span class="variable">DataReceiveTimeout</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_datasendtimeout__5bvalue_5d">DataSendTimeout [value]</a></strong>

<dd>
<p>Reads or sets the timeout value (in milliseconds) to use for data send
requests before they are canceled.  If no <em>value</em> parameter is
specified, the current value is returned; otherwise, the timeout is