uTools-Manuals/docs/php/sleep.html
2019-04-28 19:00:34 +08:00

138 lines
5.5 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>延缓执行</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.sleep" class="refentry">
<div class="refnamediv">
<h1 class="refname">sleep</h1>
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">sleep</span> &mdash; <span class="dc-title">延缓执行</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.sleep-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>sleep</strong></span>
( <span class="methodparam"><span class="type">int</span> <code class="parameter">$seconds</code></span>
) : <span class="type">int</span></div>
<p class="simpara">
程序延迟执行指定的 <code class="parameter">seconds</code> 的秒数。
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.sleep-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">seconds</code></dt>
<dd>
<p class="para">
暂停的秒数。
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.sleep-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
成功时返回 0错误时返回 <strong><code>FALSE</code></strong>
</p>
<p class="para">
如果函数的调用被一个信号中止,<span class="function"><strong>sleep()</strong></span> 会返回一个非零的值。在Windows上该值总是 <em>192</em>即Windows API常量<strong><code>WAIT_IO_COMPLETION</code></strong>的值。其他平台上该返回值是剩余未sleep的秒数。
</p>
</div>
<div class="refsect1 errors" id="refsect1-function.sleep-errors">
<h3 class="title">错误/异常</h3>
<p class="para">
如果指定的 <code class="parameter">seconds</code> 是负数,该函数会产生一个 <strong><code>E_WARNING</code></strong> 级别的错误。
</p>
</div>
<div class="refsect1 changelog" id="refsect1-function.sleep-changelog">
<h3 class="title">更新日志</h3>
<p class="para">
<table class="doctable informaltable">
<thead>
<tr>
<th>版本</th>
<th>说明</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>5.3.4</td>
<td>
在PHP 5.3.4之前Windows平台下无论 <span class="function"><strong>sleep()</strong></span> 是否成功调用,总是会返回一个 <strong><code>NULL</code></strong>
</td>
</tr>
</tbody>
</table>
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.sleep-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-4548">
<p><strong>Example #1 <span class="function"><strong>sleep()</strong></span> 的例子</strong></p>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">//&nbsp;current&nbsp;time<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">date</span><span style="color: #007700">(</span><span style="color: #DD0000">'h:i:s'</span><span style="color: #007700">)&nbsp;.&nbsp;</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">//&nbsp;sleep&nbsp;for&nbsp;10&nbsp;seconds<br /></span><span style="color: #0000BB">sleep</span><span style="color: #007700">(</span><span style="color: #0000BB">10</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;wake&nbsp;up&nbsp;!<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">date</span><span style="color: #007700">(</span><span style="color: #DD0000">'h:i:s'</span><span style="color: #007700">)&nbsp;.&nbsp;</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
<div class="example-contents"><p>
该例子会在休眠10秒后输出。
</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
05:31:23
05:31:33
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.sleep-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="usleep.html" class="function" rel="rdfs-seeAlso">usleep()</a> - 以指定的微秒数延迟执行</span></li>
<li class="member"><span class="function"><a href="time_nanosleep.html" class="function" rel="rdfs-seeAlso">time_nanosleep()</a> - 延缓执行若干秒和纳秒</span></li>
<li class="member"><span class="function"><a href="time_sleep_until.html" class="function" rel="rdfs-seeAlso">time_sleep_until()</a> - 使脚本睡眠到指定的时间为止。</span></li>
<li class="member"><span class="function"><a href="set_time_limit.html" class="function" rel="rdfs-seeAlso">set_time_limit()</a> - 设置脚本最大执行时间</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>