rquadling Fri Nov 24 09:24:40 2006 UTC
Modified files:
/phpdoc/en/reference/uodbc/functions odbc-next-result.xml
Log:
RQuadling : Undocumented feature
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/uodbc/functions/odbc-next-result.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc/en/reference/uodbc/functions/odbc-next-result.xml
diff -u phpdoc/en/reference/uodbc/functions/odbc-next-result.xml:1.3
phpdoc/en/reference/uodbc/functions/odbc-next-result.xml:1.4
--- phpdoc/en/reference/uodbc/functions/odbc-next-result.xml:1.3 Fri May
9 13:12:17 2003
+++ phpdoc/en/reference/uodbc/functions/odbc-next-result.xml Fri Nov 24
09:24:40 2006
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/uodbc.xml, last change in rev 1.29 -->
<refentry id='function.odbc-next-result'>
<refnamediv>
@@ -15,7 +15,83 @@
<methodparam><type>resource</type><parameter>result_id</parameter></methodparam>
</methodsynopsis>
<para>
- &warn.undocumented.func;
+ <function>odbc_next_result</function> will return &true; if there are
more result sets
+ available as well as allowing access to the next result set via
+ <function>odbc_fetch_array</function>,
<function>odbc_fetch_row</function>,
+ <function>odbc_result</function>, etc.
+ </para>
+ <para>
+ This function will return &false; on error.
+ </para>
+ <para>
+ The argument is a valid result identifier returned by
<function>odbc_exec</function>.
+ </para>
+ <para>
+ <example>
+ <title><function>odbc_next_result</function></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$r_Connection = odbc_connect($dsn, $username, $password);
+
+$s_SQL = <<<END_SQL
+SELECT 'A'
+SELECT 'B'
+SELECT 'C'
+END_SQL;
+
+$r_Results = odbc_exec($r_Connection, $s_SQL);
+
+$a_Row1 = odbc_fetch_array($r_Results);
+$a_Row2 = odbc_fetch_array($r_Results);
+echo "Dump first result set";
+var_dump($a_Row1, $a_Row2);
+
+echo "Get second results set ";
+var_dump(odbc_next_result($r_Results));
+
+$a_Row1 = odbc_fetch_array($r_Results);
+$a_Row2 = odbc_fetch_array($r_Results);
+echo "Dump second result set ";
+var_dump($a_Row1, $a_Row2);
+
+echo "Get third results set ";
+var_dump(odbc_next_result($r_Results));
+
+$a_Row1 = odbc_fetch_array($r_Results);
+$a_Row2 = odbc_fetch_array($r_Results);
+echo "Dump third result set ";
+var_dump($a_Row1, $a_Row2);
+
+echo "Try for a fourth result set ";
+var_dump(odbc_next_result($r_Results));
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+Dump first result set array(1) {
+ ["A"]=>
+ string(1) "A"
+}
+bool(false)
+Get second results set bool(true)
+Dump second result set array(1) {
+ ["B"]=>
+ string(1) "B"
+}
+bool(false)
+Get third results set bool(true)
+Dump third result set array(1) {
+ ["C"]=>
+ string(1) "C"
+}
+bool(false)
+Try for a fourth result set bool(false)
+]]>
+ </screen>
+ </example>
</para>
</refsect1>
</refentry>
