sync witn EN

git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@187167 c90b9560-bf6c-de11-be94-00142212c4b1

reference/sqlite/functions/sqlite-array-query.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.12 $ -->
-<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.13 $ -->
+<!-- EN-Revision: 1.12 Maintainer: jsgoupil Status: ready -->
 <refentry id="function.sqlite-array-query">
  <refnamediv>
   <refname>sqlite_array_query</refname>
@@ -9,7 +9,8 @@
    Exécute une requête SQL avec SQLite et retourne un tableau
   </refpurpose>
  </refnamediv>
- <refsect1>
+ 
+ <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>sqlite_array_query</methodname>
@@ -36,25 +37,84 @@
    </methodsynopsis>
   </classsynopsis>
   <para>
-   <function>sqlite_array_query</function> est similaire à 
-   <function>sqlite_query</function> suivi de 
-   <function>sqlite_fetch_array</function> pour chaque ligne de résultat,
-   et en les plaçant dans un tableau. Appeler <function>sqlite_array_query</function>
-   est plus rapide que de programmer cette séquence dans un script &php;.
+   <function>sqlite_array_query</function> exécute la requête donnée et
+   retourne un tableau du jeu de résultats entier. Il est similaire d'appeler
+   <function>sqlite_query</function> et ensuite
+   <function>sqlite_fetch_array</function> pour chaque ligne dans le jeu de
+   résultats. <function>sqlite_array_query</function> est de manière
+   significative plus rapide que les fonctions mentionnées ci-dessus.
+  </para>
+  <tip>
+   <para>
+    <function>sqlite_array_query</function> est plus convenable pour les
+    requêtes retournant 45 lignes ou moins. Si vous avez plus de données que
+    cela, il est recommandé que vous écriviez vos scripts avec la fonction
+    <function>sqlite_unbuffered_query</function> plutôt pour une performance
+    optimale.
+   </para>
+  </tip>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>query</parameter></term>
+     <listitem>
+      <para>
+       La requête qui sera exécutée.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>dbhandle</parameter></term>
+     <listitem>
+      <para>
+       La ressource de base de données SQLite; retournée par
+       <function>sqlite_open</function> lorsque utilisée de manière
+       procédurale. Ce paramètre n'est pas requis si vous utilisé la méthode
+       orientée objet.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>result_type</parameter></term>
+     <listitem>
+      &sqlite.result-type;
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>decode_binary</parameter></term>
+     <listitem>
+      &sqlite.decode-bin;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+  &sqlite.param-compat;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retourne une tableau du jeu de résultats entier; sinon &false;
   </para>
-  &sqlite.result-type;
   &sqlite.case-fold;
-  &sqlite.decode-bin;
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
-    <title><function>sqlite_array_query</function> traditionnel</title>
+    <title>Style procédural</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-$q = sqlite_query($dbhandle, "SELECT name, email FROM users LIMIT 25");
-$rows = array();
-while ($r = sqlite_fetch_array($q)) {
- $rows[] = $r;
+$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'];
 }
 ?>]]>
     </programlisting>
@@ -62,17 +122,10 @@ while ($r = sqlite_fetch_array($q)) {
   </para>
   <para>
    <example>
-    <title>Exemple avec <function>sqlite_array_query</function></title>
+    <title>Style orienté objet</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 'Nom : ' . $entry['name'] . '  E-mail : ' . $entry['email'];
-}
-
-/* Exemple OO */
 $dbhandle = new SQLiteDatabase('sqlitedb');
 $result = $dbhandle->arrayQuery('SELECT name, email FROM users LIMIT 25', SQLITE_ASSOC);
 foreach ($result as $entry) {
@@ -83,23 +136,20 @@ foreach ($result as $entry) {
     </programlisting>
    </example>
   </para>
-  <tip>
-   <para>
-    <function>sqlite_array_query</function> est bien adapté pour des 
-    requêtes qui retournent jusqu'à 45 lignes. Si vous avez plus 
-    de données, il est recommandé d'utiliser 
-    <function>sqlite_unbuffered_query</function> pour optimiser les performances.
-   </para>
-  </tip>
-  &sqlite.param-compat;
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
   <para>
-   Voir aussi
-   <function>sqlite_query</function>,
-   <function>sqlite_fetch_array</function> et
-   <function>sqlite_fetch_string</function>.
+   <simplelist>
+    <member><function>sqlite_query</function></member>
+    <member><function>sqlite_fetch_array</function></member>
+    <member><function>sqlite_fetch_string</function></member>
+   </simplelist>
   </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
  Local variables:
  mode: sgml