From ecb62a3422914f7e447e8f1ee8f823a5d760dd95 Mon Sep 17 00:00:00 2001
From: Kenneth Schwartz <irchtml@php.net>
Date: Wed, 19 Jan 2005 13:55:43 +0000
Subject: [PATCH] add/update examples

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@177651 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../sqlite/functions/sqlite-array-query.xml   | 27 +++++++++++-
 reference/sqlite/functions/sqlite-close.xml   | 17 +++++++-
 .../sqlite/functions/sqlite-fetch-all.xml     | 42 +++++++++++++++++--
 3 files changed, 79 insertions(+), 7 deletions(-)

diff --git a/reference/sqlite/functions/sqlite-array-query.xml b/reference/sqlite/functions/sqlite-array-query.xml
index 182ae7a52a..c99e1ac9f0 100644
--- a/reference/sqlite/functions/sqlite-array-query.xml
+++ b/reference/sqlite/functions/sqlite-array-query.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry id="function.sqlite-array-query">
  <refnamediv>
   <refname>sqlite_array_query</refname>
@@ -49,12 +49,35 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$q = sqlite_query($dbhandle, "SELECT * from foo LIMIT 100");
+$q = sqlite_query($dbhandle, "SELECT name, email FROM users LIMIT 25");
 $rows = array();
 while ($r = sqlite_fetch_array($q)) {
     $rows[] = $r;
 }
 ?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title><function>sqlite_array_query</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$dbhandle = sqlite_open('sqlitedb');
+$result = sqlite_array_query($dbhandle, "SELECT name, email FROM users LIMIT 25", SQLITE_ASSOC);
+foreach ($result as $entry) {
+    echo "Name: $entry[name]  E-mail: $entry[email]";
+}
+
+/* OO Example */
+$dbhandle =& new SQLiteDatabase('sqlitedb');
+$result = $dbhandle->arrayQuery("SELECT name, email FROM users LIMIT 25", SQLITE_ASSOC);
+foreach ($result as $entry) {
+    echo "Name: $entry[name]  E-mail: $entry[email]";
+}
+?>
 ]]>
     </programlisting>
    </example>
diff --git a/reference/sqlite/functions/sqlite-close.xml b/reference/sqlite/functions/sqlite-close.xml
index 6ff68785a5..b79dccf895 100644
--- a/reference/sqlite/functions/sqlite-close.xml
+++ b/reference/sqlite/functions/sqlite-close.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <refentry id="function.sqlite-close">
  <refnamediv>
   <refname>sqlite_close</refname>
@@ -15,7 +15,20 @@
    Closes the given <parameter>database</parameter> handle.
    If the database was persistent, it will be closed and removed from the
    persistent list.
-  </para>   
+  </para>
+  <para>
+   <example>
+    <title><function>sqlite_close</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$dbhandle = sqlite_open('sqlitedb');
+sqlite_close($dbhandle);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
   <para>
    See also <function>sqlite_open</function> and
    <function>sqlite_popen</function>.
diff --git a/reference/sqlite/functions/sqlite-fetch-all.xml b/reference/sqlite/functions/sqlite-fetch-all.xml
index c41b927442..344d0214df 100755
--- a/reference/sqlite/functions/sqlite-fetch-all.xml
+++ b/reference/sqlite/functions/sqlite-fetch-all.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <refentry id="function.sqlite-fetch-all">
  <refnamediv>
   <refname>sqlite_fetch_all</refname>
@@ -32,8 +32,44 @@
     <methodparam choice="opt"><type>bool</type><parameter>decode_binary</parameter></methodparam>
    </methodsynopsis>
   </classsynopsis>
-  
-  &warn.undocumented.func;
+  <para>
+   <function>sqlite_fetch_all</function> returns an array of the entire result
+   set from the <parameter>result</parameter> resource.  It is similar to calling
+   <function>sqlite_query</function> (or
+   <function>sqlite_unbuffered_query</function>) and then
+   <function>sqlite_fetch_array</function> for each row in the result set.
+  </para>
+  &sqlite.result-type;
+  &sqlite.case-fold;
+  &sqlite.decode-bin;
+  <para>
+   <example>
+    <title><function>sqlite_fetch_all</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$dbhandle = sqlite_open('sqlitedb');
+$query = sqlite_query($dbhandle, "SELECT name, email FROM users LIMIT 25");
+$result = sqlite_fetch_all($query, SQLITE_ASSOC);
+foreach ($result as $entry) {
+    echo "Name: $entry[name]  E-mail: $entry[email]";
+}
+
+/* OO Example */
+$dbhandle =& new SQLiteDatabase('sqlitedb');
+
+$query = $dbhandle->query("SELECT name, email FROM users LIMIT 25"); // buffered result set
+$query = $dbhandle->unbufferedQuery("SELECT name, email FROM users LIMIT 25"); // unbuffered result set
+
+$result = $query->fetchAll(SQLITE_ASSOC);
+foreach ($result as $entry) {
+    echo "Name: $entry[name]  E-mail: $entry[email]";
+}
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
 
  </refsect1>
 </refentry>