doc-fr/reference/sqlite/functions/sqlite-query.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.17 $ -->
<!-- EN-Revision: 1.14 Maintainer: jsgoupil Status: ready -->
<refentry id="function.sqlite-query">
 <refnamediv>
  <refname>sqlite_query</refname>
  <refname>SQLiteDatabase->query</refname>
  <refpurpose>Exécute une requête SQLite et lit le résultat</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>sqlite_query</methodname>
   <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
  </methodsynopsis>
  <methodsynopsis>
   <type>resource</type><methodname>sqlite_query</methodname>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
   <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
  </methodsynopsis>
  &title.oop;
  <classsynopsis>
   <ooclass><classname>SQLiteDatabase</classname></ooclass>
   <methodsynopsis>
    <type>SQLiteResult</type><methodname>query</methodname>
    <methodparam><type>string</type><parameter>query</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
   </methodsynopsis>
  </classsynopsis>
  <para>
   Exécute la requête SQL <parameter>query</parameter> dans une base SQLite.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>query</parameter></term>
     <listitem>
      <para>
       La requête à être 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>
   </variablelist>
  </para>
  &sqlite.param-compat;
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne une ressource de résultat ou &false; en cas d'échec.
   Pour les requêtes qui retournent des lignes, la ressource de résultat
   peut être utilisée avec les fonctions comme 
   <function>sqlite_fetch_array</function> et
   <function>sqlite_seek</function>.
  </para>
  <para>
   Indépendamment du type, cette fonction retournera &false; si la
   requête échoue.
  </para>
  <para>
   <function>sqlite_query</function> retourne un résultat bufférisé.
   C'est très pratique pour des résultats de petites tailles, où vous 
   aurez besoin d'accéder aléatoirement aux lignes. Les résultats
   bufférisés allouent la mémoire nécessaire pour stocker tout le
   résultat, et ne se termineront qu'une fois toutes ces données
   lues. Si vous n'avez besoin que d'un accès séquentiel aux
   données, il est recommandé d'utiliser 
   <function>sqlite_unbuffered_query</function>.
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <warning>
   <simpara>
    SQLite <emphasis>va</emphasis> exécuter les requêtes multiples, séparées par
    des points-virgules, ce qui vous permet d'exécuter plusieurs requêtes SQL
    en une seule fois.
   </simpara>
   <simpara>
    Lorsque vous exécutez des requêtes multiples, la valeur retournée 
    par cette fonction sera &false; si une erreur s'est produite, mais
    indéfini dans les autres cas (cela peut être &true; en cas de 
    succès, ou bien elle peut retourner un résultat).
   </simpara>
  </warning>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>sqlite_unbuffered_query</function></member>
    <member><function>sqlite_array_query</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
 sgml-omittag:t
 sgml-shorttag:t
 sgml-minimize-attributes:nil
 sgml-always-quote-attributes:t
 sgml-indent-step:1
 sgml-indent-data:t
 sgml-parent-document:nil
 sgml-default-dtd-file:"../../manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil
 End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->