<!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>Move the internal result pointer to the next result</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.fbsql-list-tables.html">fbsql_list_tables</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.fbsql-num-fields.html">fbsql_num_fields</a></div>
<div class="up"><a href="ref.fbsql.html">FrontBase Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.fbsql-next-result" class="refentry">
<div class="refnamediv">
<h1 class="refname">fbsql_next_result</h1>
<p class="verinfo">(PHP 4 >= 4.0.6, PHP 5)</p><p class="refpurpose"><span class="refname">fbsql_next_result</span> — <span class="dc-title">Move the internal result pointer to the next result</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.fbsql-next-result-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">bool</span> <span class="methodname"><strong>fbsql_next_result</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$result</code></span>
)</div>
<p class="para rdfs-comment">
When sending more than one SQL statement to the server or
executing a stored procedure with multiple results will cause the
server to return multiple result sets. This function will test
for additional results available form the server. If an
additional result set exists it will free the existing result set
and prepare to fetch the words from the new result set.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.fbsql-next-result-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">
result</code></em></span><dd>
<p class="para">A result identifier
returned by <span class="function"><a href="function.fbsql-query.html" class="function">fbsql_query()</a></span> or
<span class="function"><a href="function.fbsql-db-query.html" class="function">fbsql_db_query()</a></span>.</p></dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.fbsql-next-result-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns <strong><code>TRUE</code></strong> if an additional result set was available or <strong><code>FALSE</code></strong>
otherwise.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.fbsql-next-result-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-1131">
<p><strong>Example #1 <span class="function"><strong>fbsql_next_result()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$link </span><span style="color: #007700">= </span><span style="color: #0000BB">fbsql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">, </span><span style="color: #DD0000">"_SYSTEM"</span><span style="color: #007700">, </span><span style="color: #DD0000">"secret"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">fbsql_select_db</span><span style="color: #007700">(</span><span style="color: #DD0000">"MyDB"</span><span style="color: #007700">, </span><span style="color: #0000BB">$link</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$SQL </span><span style="color: #007700">= </span><span style="color: #DD0000">"Select * from table1; select * from table2;"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$rs </span><span style="color: #007700">= </span><span style="color: #0000BB">fbsql_query</span><span style="color: #007700">(</span><span style="color: #0000BB">$SQL</span><span style="color: #007700">, </span><span style="color: #0000BB">$link</span><span style="color: #007700">);<br />do {<br /> while (</span><span style="color: #0000BB">$row </span><span style="color: #007700">= </span><span style="color: #0000BB">fbsql_fetch_row</span><span style="color: #007700">(</span><span style="color: #0000BB">$rs</span><span style="color: #007700">)) {<br /> }<br />} while (</span><span style="color: #0000BB">fbsql_next_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$rs</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">fbsql_free_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$rs</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">fbsql_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$link</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.fbsql-list-tables.html">fbsql_list_tables</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.fbsql-num-fields.html">fbsql_num_fields</a></div>
<div class="up"><a href="ref.fbsql.html">FrontBase Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
