From 519544ccbd0b5cbb163e36006e332732485b0399 Mon Sep 17 00:00:00 2001
From: Brian Moon <brianlmoon@php.net>
Date: Thu, 28 Sep 2000 19:27:37 +0000
Subject: [PATCH] added docs for mysql_fetch_assoc

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@33062 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/mysql.xml | 67 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 64 insertions(+), 3 deletions(-)

diff --git a/functions/mysql.xml b/functions/mysql.xml
index 4325ef3498..053ab8d15c 100644
--- a/functions/mysql.xml
+++ b/functions/mysql.xml
@@ -593,7 +593,7 @@ echo mysql_errno().": ".mysql_error()."&lt;BR>";
    <refnamediv>
     <refname>mysql_fetch_array</refname> 
     <refpurpose>
-     Fetch a result row as an associative array
+     Fetch a result row as an associative array, a numeric array, or both.
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -643,15 +643,76 @@ select t1.f1 as foo t2.f1 as bar from t1, t2
     </para>
     <para>
      For further details, see also
-     <function>mysql_fetch_row</function>.
+     <function>mysql_fetch_row</function> and <function>mysql_fetch_assoc</function>.
     </para>
     <example>
      <title><function>Mysql_fetch_array</function></title>
      <programlisting role="php">
 &lt;?php 
 mysql_connect ($host, $user, $password);
-$result = mysql_db_query ("database","select * from table");
+$result = mysql_db_query ("database","select user_id, fullname from table");
 while ($row = mysql_fetch_array ($result)) {
+    echo "user_id: ".$row["user_id"]."<br>\n";
+    echo "user_id: ".$row[0]."<br>\n";
+    echo "fullname: ".$row["fullname"]."<br>\n";
+    echo "fullname: ".$row[1]."<br>\n";
+}
+mysql_free_result ($result);
+?>
+     </programlisting>
+    </example>
+   </refsect1>
+  </refentry>
+
+  <refentry id="function.mysql-fetch-assoc">
+   <refnamediv>
+    <refname>mysql_fetch_assoc</refname> 
+    <refpurpose>
+     Fetch a result row as an associative array
+    </refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>array <function>mysql_fetch_assoc</function></funcdef>
+      <paramdef>int <parameter>result</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para> 
+     Returns an associative array that corresponds to the fetched row,
+     or false if there are no more rows.</para>
+    <para>
+     <function>mysql_fetch_assoc</function> is eqivilant to calling 
+     <function>mysql_fetch_array</function> with MYSQL_ASSOC for the
+     optional second parameter.  It only returns an associative array.
+     This is the way <function>mysql_fetch_array</function> originally
+     worked.  If you need the numeric indices as well as the
+     associative, use <function>mysql_fetch_array</function>.
+    </para>
+    <para>
+     If two or more columns of the result have the same field names,
+     the last column will take precedence. To access the other column(s)
+     of the same name, you must use <function>mysql_fetch_array</function> and
+     have it return the numeric indices as well.
+    </para>
+    <para>
+     An important thing to note is that using
+     <function>mysql_fetch_assoc</function> is NOT significantly
+     slower than using <function>mysql_fetch_row</function>, while it
+     provides a significant added value.
+    </para>
+    <para>
+     For further details, see also
+     <function>mysql_fetch_row</function> and <function>mysql_fetch_array</function>.
+    </para>
+    <example>
+     <title><function>Mysql_fetch_assoc</function></title>
+     <programlisting role="php">
+&lt;?php 
+mysql_connect ($host, $user, $password);
+$result = mysql_db_query ("database","select * from table");
+while ($row = mysql_fetch_assoc ($result)) {
     echo $row["user_id"];
     echo $row["fullname"];
 }