From cfd8646a7a09121ab6c5f4645e5d8e44ad26468e Mon Sep 17 00:00:00 2001
From: Dan Kalowsky <kalowsky@php.net>
Date: Thu, 28 Jun 2001 15:54:29 +0000
Subject: [PATCH] updated to reflect new functionality in 4.0.6, and warn users
 of the future change

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@50297 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/uodbc.xml | 48 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/functions/uodbc.xml b/functions/uodbc.xml
index 9a30623a0e..91cd8a68b9 100644
--- a/functions/uodbc.xml
+++ b/functions/uodbc.xml
@@ -506,6 +506,54 @@
      array. The array will contain the column values starting at array
      index 0.
     </para>
+	<para>
+	 <example>
+		<title><function>odbc_fetch_into</function> pre 4.0.6 example </title>
+		<programlisting role="php">
+$rc = odbc_fetch_into($res_id, $my_array);
+		</programlisting>
+		or
+		<programlisting role="php">
+$rc = odbc_fetch_into($res_id, $row, $my_array);
+
+$rc = odbc_fetch_into($res_id, 1, $my_array);
+		</programlisting>
+	 </example>
+	</para>
+	<para>
+	 As of PHP 4.0.5 the <parameter>result_array</parameter> does not need
+	 to be passed by reference any longer.
+	</para>
+	<para>
+	 As of PHP 4.0.6 the <parameter>rownumber</parameter> cannot be passed
+	 as a constant, but rather as a variable.  
+	</para>
+	<para>
+	 <example>
+		<title><function>odbc_fetch_into</function> 4.0.6 example</title>
+		<programlisting role="php">
+$rc = odbc_fetch_into($res_id, $my_array);
+		</programlisting>
+		or
+		<programlisting role="php">
+$row = 1;
+$rc = odbc_fetch_into($res_id, $row, $my_array);
+		</programlisting>
+	 </example>
+	</para>
+	<para>
+	 Future:  In PHP 4.1, this function will be moved to the following format:
+     <funcsynopsis>
+      <funcprototype>
+       <funcdef>int <function>odbc_fetch_into</function></funcdef>
+       <paramdef>int <parameter>result_id</parameter></paramdef>
+       <paramdef>array <parameter>result_array</parameter></paramdef>
+       <paramdef>int <parameter><optional>rownumber</optional></parameter></paramdef>
+      </funcprototype>
+     </funcsynopsis>
+	 Please note, that <parameter>rownumber</parameter> will be optional, 
+	 while <parameter>result_array</parameter> is not.
+	</para>
    </refsect1>
   </refentry>