Files
doc-fr/reference/sqlite/functions/sqlite-query.xml
Damien Seguy 003d3f2012 initial translation
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@133884 c90b9560-bf6c-de11-be94-00142212c4b1
2003-07-01 14:15:00 +00:00

95 lines
3.7 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.sqlite-query">
<refnamediv>
<refname>sqlite_query</refname>
<refpurpose>Ex&eacute;cute une requ&ecirc;te SQLite et lit le r&eacute;sultat</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>resource</type><methodname>sqlite_query</methodname>
<methodparam><type>resource</type><parameter>db</parameter></methodparam>
<methodparam><type>string</type><parameter>query</parameter></methodparam>
</methodsynopsis>
<methodsynopsis>
<type>resource</type><methodname>sqlite_query</methodname>
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam><type>resource</type><parameter>db</parameter></methodparam>
</methodsynopsis>
<para>
<function>sqlite_query</function> ex&eacute;cute la requ&ecirc;te SQL <parameter>query</parameter>
dans la base SQLite <parameter>db</parameter>.
</para>
<para>
Pour les requ&ecirc;tes qui retournent des lignes, cette fonction
va retourner une ressource que vous pourrez utiliser avec des fonctions
telles que <function>sqlite_fetch_array</function> et
<function>sqlite_seek</function>.
</para>
<para>
Pour les autres types de requ&ecirc;tes, cette fonction va retourner un
bool&eacute;en, en guise de r&eacute;sultat. &true; pour le succ&egrave;s, et &false;
pour l'&eacute;chec.
</para>
<para>
Ind&eacute;pendamment du type, cette fonction retournera &false; si la
requ&ecirc;te &eacute;choue.
</para>
<para>
<function>sqlite_query</function> retourne une r&eacute;sultat bufferis&eacute;.
C'est tr&egrave;s pratique pour des r&eacute;sultats de petites tailles, o&ugrave; vous
aurez besoin d'acc&eacute;der al&eacute;atoirement aux lignes. Les r&eacute;sultats
bufferis&eacute;s allouent la m&eacute;moire n&eacute;cessaire pour stocker tout le
r&eacute;sultat, et ne se termineront qu'une fois toutes ces donn&eacute;es
ont &eacute;t&eacute; lues. Si vous n'avez besoin que d'un acc&egrave;s s&eacute;quentiel aux
donn&eacute;es, il est recommand&eacute; d'utiliser
<function>sqlite_unbuffered_query</function>.
</para>
<note>
<simpara>
Deux syntaxes alternatives sont support&eacute;es pour assurer la compatibilit&eacute;
avec les autres bases de donn&eacute;es (telles que MySQL) :
La forme recommand&eacute;e est la premi&egrave;re, o&ugrave; le param&egrave;tre
<parameter>db</parameter> est le premier dans la fonction.
</simpara>
</note>
<warning>
<simpara>
SQLite <emphasis>va</emphasis> ex&eacute;cuter les requ&ecirc;tes multiples, s&eacute;par&eacute;es par
des points-virgules, ce qui vous permet d'ex&eacute;cuter plusieurs requ&ecirc;tes SQL
en une seule fois.
</simpara>
<simpara>
Lorsque vous ex&eacute;cutez des requ&ecirc;tes multiples, la valeur retourn&eacute;e
par cette fonction sera &false; si une erreur s'est produite, mais
ind&eacute;fini dans les autres cas (cela peut &ecirc;tre &true; en cas de
succ&egrave;s, ou bien elle peut retourne un r&eacute;sultat).
</simpara>
</warning>
<para>
Voir aussi
<function>sqlite_array_query</function>.
</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
-->