<!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>Wait for an event to be posted by the database</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.ibase-trans.html">ibase_trans</a></div>
<div class="next" style="text-align: right; float: right;"><a href="book.fbsql.html">FrontBase</a></div>
<div class="up"><a href="ref.ibase.html">Firebird/InterBase Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.ibase-wait-event" class="refentry">
<div class="refnamediv">
<h1 class="refname">ibase_wait_event</h1>
<p class="verinfo">(PHP 5)</p><p class="refpurpose"><span class="refname">ibase_wait_event</span> — <span class="dc-title">Wait for an event to be posted by the database</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.ibase-wait-event-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">string</span> <span class="methodname"><strong>ibase_wait_event</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$event_name1</code></span>
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$event_name2</code></span>
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$...</code></span>
]] )</div>
<div class="methodsynopsis dc-description">
<span class="type">string</span> <span class="methodname"><strong>ibase_wait_event</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$connection</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$event_name1</code></span>
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$event_name2</code></span>
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$...</code></span>
]] )</div>
<p class="para rdfs-comment">
This function suspends execution of the script until one of the specified events
is posted by the database. The name of the event that was posted is returned. This
function accepts up to 15 event arguments.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.ibase-wait-event-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">event_name1</code></em></span>
<dd>
<p class="para">
The event name.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">event_name2</code></em></span>
<dd>
<p class="para">
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">...</code></em></span>
<dd>
<p class="para">
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.ibase-wait-event-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns the name of the event that was posted.
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.ibase-wait-event-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.ibase-set-event-handler.html" class="function" rel="rdfs-seeAlso">ibase_set_event_handler()</a> - Register a callback function to be called when events are posted</span></li>
<li class="member"> <span class="function"><a href="function.ibase-free-event-handler.html" class="function" rel="rdfs-seeAlso">ibase_free_event_handler()</a> - Cancels a registered event handler</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.ibase-trans.html">ibase_trans</a></div>
<div class="next" style="text-align: right; float: right;"><a href="book.fbsql.html">FrontBase</a></div>
<div class="up"><a href="ref.ibase.html">Firebird/InterBase Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
