<!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>Creates EvTimer stopped watcher object</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="evtimer.construct.html">EvTimer::__construct</a></div>
<div class="next" style="text-align: right; float: right;"><a href="evtimer.set.html">EvTimer::set</a></div>
<div class="up"><a href="class.evtimer.html">EvTimer</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="evtimer.createstopped" class="refentry">
<div class="refnamediv">
<h1 class="refname">EvTimer::createStopped</h1>
<p class="verinfo">(PECL ev >= 0.2.0)</p><p class="refpurpose"><span class="refname">EvTimer::createStopped</span> — <span class="dc-title">Creates EvTimer stopped watcher object</span></p>
</div>
<div class="refsect1 description" id="refsect1-evtimer.createstopped-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="modifier">final</span>
<span class="modifier">public</span>
<span class="modifier">static</span>
<span class="type"><a href="class.evtimer.html" class="type EvTimer">EvTimer</a></span>
<span class="methodname"><strong>EvTimer::createStopped</strong></span>
( <span class="methodparam">
<span class="type">double</span>
<code class="parameter">$after</code>
</span>
, <span class="methodparam">
<span class="type">double</span>
<code class="parameter">$repeat</code>
</span>
, <span class="methodparam">
<span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span>
<code class="parameter">$callback</code>
</span>
[, <span class="methodparam">
<span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span>
<code class="parameter">$data</code>
<span class="initializer"> = <strong><code>NULL</code></strong></span>
</span>
[, <span class="methodparam">
<span class="type">int</span>
<code class="parameter">$priority</code>
<span class="initializer"> = 0</span>
</span>
]] )</div>
<p class="para rdfs-comment">
Creates EvTimer stopped watcher object. Unlike
<span class="methodname"><a href="evtimer.construct.html" class="methodname">EvTimer::__construct()</a></span>
, this method doesn't start the watcher automatically.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-evtimer.createstopped-parameters">
<h3 class="title">Parameters</h3>
<dl>
<dt>
<span class="term">
<em><code class="parameter">after</code></em>
</span>
<dd>
<p class="para">
Configures the timer to trigger after
<em><code class="parameter">after</code></em>
seconds.
</p>
</dd>
</dt>
<dt>
<span class="term">
<em><code class="parameter">repeat</code></em>
</span>
<dd>
<p class="para">
If repeat is
<strong><code>0.0</code></strong>
, then it will automatically be stopped once the timeout is reached. If
it is positive, then the timer will automatically be configured to
trigger again every repeat seconds later, until stopped manually.
</p>
</dd>
</dt>
<dt>
<span class="term">
<em><code class="parameter">callback</code></em>
</span>
<dd>
<p class="para">
See
<a href="ev.watcher-callbacks.html" class="link">Watcher callbacks</a>
.
</p>
</dd>
</dt>
<dt>
<span class="term">
<em><code class="parameter">data</code></em>
</span>
<dd>
<p class="para">
Custom data associated with the watcher.
</p>
</dd>
</dt>
<dt>
<span class="term">
<em><code class="parameter">priority</code></em>
</span>
<dd>
<p class="para">
<a href="class.ev.html#ev.constants.watcher-pri" class="link">Watcher priority</a>
</p>
</dd>
</dt>
</dl>
</div>
<div class="refsect1 returnvalues" id="refsect1-evtimer.createstopped-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns EvTimer watcher object on success.
</p>
</div>
<div class="refsect1 examples" id="refsect1-evtimer.createstopped-examples">
<h3 class="title">Examples</h3>
<div class="example" id="example-3634">
<p><strong>Example #1 Monotor changes of /var/log/messages. Avoid missing updates by means of one second delay</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$timer </span><span style="color: #007700">= </span><span style="color: #0000BB">EvTimer</span><span style="color: #007700">::</span><span style="color: #0000BB">createStopped</span><span style="color: #007700">(</span><span style="color: #0000BB">0.</span><span style="color: #007700">, </span><span style="color: #0000BB">1.02</span><span style="color: #007700">, function (</span><span style="color: #0000BB">$w</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$w</span><span style="color: #007700">-></span><span style="color: #0000BB">stop</span><span style="color: #007700">();<br /><br /> </span><span style="color: #0000BB">$stat </span><span style="color: #007700">= </span><span style="color: #0000BB">$w</span><span style="color: #007700">-></span><span style="color: #0000BB">data</span><span style="color: #007700">;<br /><br /> </span><span style="color: #FF8000">// 1 second after the most recent change of the file<br /> </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"Current size: %ld\n"</span><span style="color: #007700">, </span><span style="color: #0000BB">$stat</span><span style="color: #007700">-></span><span style="color: #0000BB">attr</span><span style="color: #007700">()[</span><span style="color: #DD0000">'size'</span><span style="color: #007700">]);<br />});<br /><br /></span><span style="color: #0000BB">$stat </span><span style="color: #007700">= new </span><span style="color: #0000BB">EvStat</span><span style="color: #007700">(</span><span style="color: #DD0000">"/var/log/messages"</span><span style="color: #007700">, </span><span style="color: #0000BB">0.</span><span style="color: #007700">, function () use (</span><span style="color: #0000BB">$timer</span><span style="color: #007700">) {<br /> </span><span style="color: #FF8000">// Reset timer watcher<br /> </span><span style="color: #0000BB">$timer</span><span style="color: #007700">-></span><span style="color: #0000BB">again</span><span style="color: #007700">();<br />});<br /><br /></span><span style="color: #0000BB">$timer</span><span style="color: #007700">-></span><span style="color: #0000BB">data </span><span style="color: #007700">= </span><span style="color: #0000BB">$stat</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">Ev</span><span style="color: #007700">::</span><span style="color: #0000BB">run</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</div>
<div class="refsect1 seealso" id="refsect1-evtimer.createstopped-seealso">
<h3 class="title">See Also</h3>
<ul class="simplelist">
<li class="member">
<span class="methodname"><a href="evtimer.construct.html" class="methodname" rel="rdfs-seeAlso">EvTimer::__construct()</a> - Constructs an EvTimer watcher object</span>
</li>
<li class="member">
<a href="class.evperiodic.html" class="classname">EvPeriodic</a>
</li>
</ul>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="evtimer.construct.html">EvTimer::__construct</a></div>
<div class="next" style="text-align: right; float: right;"><a href="evtimer.set.html">EvTimer::set</a></div>
<div class="up"><a href="class.evtimer.html">EvTimer</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
