From 8432ea1cc4b735944bf4d2d17b7e8f98fb8f56cc Mon Sep 17 00:00:00 2001
From: Richard Quadling <rquadling@php.net>
Date: Fri, 24 Nov 2006 09:24:40 +0000
Subject: [PATCH] RQuadling : Undocumented feature

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@223800 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../uodbc/functions/odbc-next-result.xml      | 80 ++++++++++++++++++-
 1 file changed, 78 insertions(+), 2 deletions(-)

diff --git a/reference/uodbc/functions/odbc-next-result.xml b/reference/uodbc/functions/odbc-next-result.xml
index cbb1ad782d..34e1b5c2fa 100644
--- a/reference/uodbc/functions/odbc-next-result.xml
+++ b/reference/uodbc/functions/odbc-next-result.xml
@@ -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>