<!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>Makes signal event pending</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="event.add.html">Event::add</a></div>
<div class="next" style="text-align: right; float: right;"><a href="event.addtimer.html">Event::addTimer</a></div>
<div class="up"><a href="class.event.html">Event</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="event.addsignal" class="refentry">
<div class="refnamediv">
<h1 class="refname">Event::addSignal</h1>
<p class="verinfo">(PECL event >= 1.2.6-beta)</p><p class="refpurpose"><span class="refname">Event::addSignal</span> — <span class="dc-title">Makes signal event pending</span></p>
</div>
<div class="refsect1 description" id="refsect1-event.addsignal-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="modifier">public</span>
<span class="type">bool</span>
<span class="methodname"><strong>Event::addSignal</strong></span>
([ <span class="methodparam">
<span class="type">double</span>
<code class="parameter">$timeout</code>
</span>
] )</div>
<p class="para rdfs-comment">
<span class="methodname"><strong>Event::addSignal()</strong></span>
is an alias of
<span class="methodname"><a href="event.add.html" class="methodname">Event::add()</a></span>
</p>
</div>
<div class="refsect1 examples" id="refsect1-event.addsignal-examples">
<h3 class="title">Examples</h3>
<div class="example" id="example-4246">
<p><strong>Example #1
<span class="function"><strong>Event::addSignal()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/*<br />Launch it in a terminal window:<br /><br />$ php examples/signal.php<br /><br />In another terminal window find out the pid and send SIGTERM, e.g.:<br /><br />$ ps aux | grep examp<br />ruslan 3976 0.2 0.0 139896 11256 pts/1 S+ 10:25 0:00 php examples/signal.php<br />ruslan 3978 0.0 0.0 9572 864 pts/2 S+ 10:26 0:00 grep --color=auto examp<br />$ kill -TERM 3976<br /><br />At the first terminal window you should catch the following:<br /><br />Caught signal 15<br />*/<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">MyEventSignal </span><span style="color: #007700">{<br /> private </span><span style="color: #0000BB">$base</span><span style="color: #007700">, </span><span style="color: #0000BB">$ev</span><span style="color: #007700">;<br /><br /> public function </span><span style="color: #0000BB">__construct</span><span style="color: #007700">(</span><span style="color: #0000BB">$base</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">base </span><span style="color: #007700">= </span><span style="color: #0000BB">$base</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">ev </span><span style="color: #007700">= </span><span style="color: #0000BB">Event</span><span style="color: #007700">::</span><span style="color: #0000BB">signal</span><span style="color: #007700">(</span><span style="color: #0000BB">$base</span><span style="color: #007700">, </span><span style="color: #0000BB">SIGTERM</span><span style="color: #007700">, array(</span><span style="color: #0000BB">$this</span><span style="color: #007700">, </span><span style="color: #DD0000">'eventSighandler'</span><span style="color: #007700">));<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">ev</span><span style="color: #007700">-></span><span style="color: #0000BB">addSignal</span><span style="color: #007700">();<br /> }<br /><br /> public function </span><span style="color: #0000BB">eventSighandler</span><span style="color: #007700">(</span><span style="color: #0000BB">$no</span><span style="color: #007700">, </span><span style="color: #0000BB">$c</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">"Caught signal </span><span style="color: #0000BB">$no</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">base</span><span style="color: #007700">-></span><span style="color: #0000BB">exit</span><span style="color: #007700">();<br /> }<br />}<br /><br /></span><span style="color: #0000BB">$base </span><span style="color: #007700">= new </span><span style="color: #0000BB">EventBase</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= new </span><span style="color: #0000BB">MyEventSignal</span><span style="color: #007700">(</span><span style="color: #0000BB">$base</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$base</span><span style="color: #007700">-></span><span style="color: #0000BB">loop</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>The above example will output
something similar to:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
Caught signal 15
</pre></div>
</div>
</div>
</div>
<div class="refsect1 seealso" id="refsect1-event.addsignal-seealso">
<h3 class="title">See Also</h3>
<ul class="simplelist">
<li class="member">
<span class="methodname"><a href="event.add.html" class="methodname" rel="rdfs-seeAlso">Event::add()</a> - Makes event pending</span>
</li>
<li class="member">
<span class="methodname"><a href="event.del.html" class="methodname" rel="rdfs-seeAlso">Event::del()</a> - Makes event non-pending</span>
</li>
<li class="member">
<span class="methodname"><a href="event.delsignal.html" class="methodname" rel="rdfs-seeAlso">Event::delSignal()</a> - Makes signal event non-pending</span>
</li>
<li class="member">
<span class="methodname"><a href="event.signal.html" class="methodname" rel="rdfs-seeAlso">Event::signal()</a> - Constructs signal event object</span>
</li>
</ul>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="event.add.html">Event::add</a></div>
<div class="next" style="text-align: right; float: right;"><a href="event.addtimer.html">Event::addTimer</a></div>
<div class="up"><a href="class.event.html">Event</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
