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/uod
bc/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>