cvs: phpdoc /fr/functions dba.xml
| From: | Damien Seguy | Date: | Tue, 31 Jul 2001 07:35:51 +0000 |
| Subject: | cvs: phpdoc /fr/functions dba.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336614@lists.php.net to get a copy of this message | ||
dams Tue Jul 31 03:35:51 2001 EDT
Modified files:
/phpdoc/fr/functions dba.xml
Log:
Adding last missing URL
Index: phpdoc/fr/functions/dba.xml diff -u phpdoc/fr/functions/dba.xml:1.9 phpdoc/fr/functions/dba.xml:1.10 --- phpdoc/fr/functions/dba.xml:1.9 Sat Jul 7 18:22:05 2001 +++ phpdoc/fr/functions/dba.xml Tue Jul 31 03:35:49 2001 @@ -1,81 +1,108 @@ - <reference id="ref.dba"> - <title>DBA</title> - <titleabbrev>DBA</titleabbrev> - <partintro> - <para> - Ces fonctions sont l'interface avec les bases de type Berkeley. - </para> - <para> - C'est une couche générale pour plusieurs bases de - données sur fichiers. En tant que tel, les fonctionnalités - sont limitées à une partie des fonctionnalités des - bases de données modernes, comme - <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink>. (A ne pas confondre avec - IBM's DB2 software, qui fonctionne avec <link linkend="ref.odbc">ODBC</link>.). - </para> - <para> - Le comportement de certaines fonctions dépends de la base de - données utilisée. Par exemple - <function>dba_optimize</function> et <function>dba_sync</function> - n'auront pas le même effet d'une base à l'autre. - </para> - <para> - Pour ajouter le support d'une base dba, il suffit d'ajouter l'option - de configuration --with adéquate. Les bases suivantes sont supportées : - <itemizedlist> - <listitem> - <simpara> - Dbm est la plus ancienne des base de données de type Berkeley. - Il vaut mieux l'éviter si possible. Les fonctions de - compatibilités codées dans DB2 et gdbm - ne sont pas supportées, car elles ne sont compatibles qu'au - niveau du code source, et ne peuvent pas gérer le format dbm originel. - (<link linkend="install.configure.with-dbm">--with-dbm</link>). - </simpara> - </listitem> - <listitem> - <simpara> - ndbm est un nouveau type de dbm plus flexible. Il a cependant - la majorité des limitations du genre. - (<link linkend="install.configure.with-ndbm">--with-ndbm</link>). - </simpara> - </listitem> - <listitem> - <simpara> - gdbm est <ulink url="">la base dbm GNU</ulink>. - (<link linkend="install.configure.with-gdbm">--with-gdbm</link>). - </simpara> - </listitem> - <listitem> - <simpara> - db2 est <ulink url="&url.sleepycat;">DB2 de Sleepycat Software</ulink>. Elle se - décrit comme un "ensemble d'outils qui fournissent une base - de données performante, tant pour les applications - indépendantes que pour le client/serveur". - (<link linkend="install.configure.with-db2">--with-db2</link>). - </simpara> - </listitem> - <listitem> - <simpara> - DB3 est le <ulink url="&url.sleepycat;">DB3 de Sleepycat Software</ulink>. - (<link linkend="install.configure.with-db3">--with-db3</link>). - </simpara> - </listitem> - <listitem> - <simpara> - cdb est "un package rapide, robuste, léger, pour créer et - lire des bases de données constantes". C'est l'auteur de qmail qui - l'a écrit, et elle est disponible <ulink url="">ici</ulink>. Puisque - c'est une base constante, elle ne supporte que la lecture. - (<link linkend="install.configure.with-cdb">--with-cdb</link>). - </simpara> - </listitem> - </itemizedlist> +<reference id="ref.dba"> + <title>DBA</title> + <titleabbrev>DBA</titleabbrev> + <partintro> + <para> + Ces fonctions sont l'interface avec les bases de type Berkeley. + </para> + <para> + C'est une couche générale pour plusieurs bases de + données sur fichiers. En tant que tel, les fonctionnalités + sont limitées à une partie des fonctionnalités des + bases de données modernes, comme + <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink> (A ne pas confondre avec + IBM's DB2 software, qui fonctionne avec <link linkend="ref.odbc">ODBC</link>). + </para> + <para> + Le comportement de certaines fonctions dépends de la base de + données utilisée. Par exemple + <function>dba_optimize</function> et <function>dba_sync</function> + n'auront pas le même effet d'une base à l'autre. + </para> + <para> + Lors de l'utilisation de la fonction <function>dba_open</function> ou de + <function>dba_popen</function>, une des librairies suivante doit + être fournie comme argument. La liste complète des librairies + supportées par votre configuration est disponible avec la fonction + <function>phpinfo</function>. (Pour ajouter le support de l'une + de ces librairies, ajouter l'option de configuration + <literal>--with-XXXX</literal>). + <table> + <title>Liste des librairies DBA</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Librairie</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>dbm</literal></entry> + <entry> + Dbm est la plus ancienne des base de données de type Berkeley. + Il vaut mieux l'éviter si possible. Les fonctions de + compatibilités codées dans DB2 et gdbm + ne sont pas supportées, car elles ne sont compatibles qu'au + niveau du code source, et ne peuvent pas gérer le format dbm originel. + (<link linkend="install.configure.with-dbm"><option role="configure"> + --with-dbm</option></link>). + </entry> + </row> + <row> + <entry><literal>ndbm</literal></entry> + <entry> + ndbm est un nouveau type de dbm plus flexible. Il a cependant + la majorité des limitations du genre. + (<link linkend="install.configure.with-ndbm"><option role="configure"> + --with-ndbm</option></link>). + </entry> + </row> + <row> + <entry><literal>gdbm</literal></entry> + <entry> + gdbm est <ulink url="&url.gdbm;">la base dbm GNU</ulink>. + (<link linkend="install.configure.with-gdbm"><option role="configure"> + --with-gdbm</option></link>). + </entry> + </row> + <row> + <entry><literal>db2</literal></entry> + <entry> + db2 est <ulink url="&url.sleepycat;">DB2 de Sleepycat Software</ulink>. Elle se + décrit comme un "ensemble d'outils qui fournissent une base + de données performante, tant pour les applications + indépendantes que pour le client/serveur". + (<link linkend="install.configure.with-db2"><option role="configure"> + --with-db2</option></link>). + </entry> + </row> + <row> + <entry><literal>db3</literal></entry> + <entry> + DB3 est le <ulink url="&url.sleepycat;">DB3 de Sleepycat Software</ulink>. + (<link linkend="install.configure.with-db3"><option role="configure"> + --with-db3</option></link>). + </entry> + </row> + <row> + <entry><literal>cdb</literal></entry> + <entry> + cdb est "un package rapide, robuste, léger, pour créer et + lire des bases de données constantes". C'est l'auteur de qmail qui + l'a écrit, et elle est disponible <ulink url="&url.cdb;">ici</ulink>. Puisque + c'est une base constante, elle ne supporte que la lecture. + (<link linkend="install.configure.with-cdb">--with-cdb</link>). + </entry> + </row> + </tbody> + </tgroup> + </table> </para> <para> <example> <title>Exemple DBA</title> - <programlisting role="php"> + <programlisting role="php"> <?php $id = dba_open("/tmp/test.db", "n", "db2"); if(!$id) { @@ -89,30 +116,30 @@ } dba_close($id); ?> - </programlisting> - </example> - </para> - <para> - DBA gère les données binaires, et n'a pas de limites arbitraires. - Elle hérite de toutes les limites de la base sous jacentes. - </para> - <para> - Toutes les bases de données sur fichiers doivent fournir un moyen - de changer le mode d'accès au fichier d'une base, et si possible, - de toutes les bases. Le mode d'accès est généralement - passé en 4ème argument à <function>dba_open</function> - ou <function>dba_popen</function>. - </para> - <para> - Vous pouvez accéder à toutes les entrées d'une - base d'une manière linéaire, avec les fonctions - <function>dba_firstkey</function> et <function>dba_nextkey</function>. - Vous ne devez pas modifier une base lorsque vous la traversez ainsi. - </para> - <para> - <example> - <title>Passer en revue une base</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + DBA gère les données binaires, et n'a pas de limites arbitraires. + Elle hérite de toutes les limites de la base sous jacentes. + </para> + <para> + Toutes les bases de données sur fichiers doivent fournir un moyen + de changer le mode d'accès au fichier d'une base, et si possible, + de toutes les bases. Le mode d'accès est généralement + passé en 4ème argument à <function>dba_open</function> + ou <function>dba_popen</function>. + </para> + <para> + Vous pouvez accéder à toutes les entrées d'une + base d'une manière linéaire, avec les fonctions + <function>dba_firstkey</function> et <function>dba_nextkey</function>. + Vous ne devez pas modifier une base lorsque vous la traversez ainsi. + </para> + <para> + <example> + <title>Passer en revue une base</title> + <programlisting role="php"> <?php # ...ouverture de la base... $key = dba_firstkey($id); @@ -125,449 +152,483 @@ for($i = 0; $i < count($handle_later); $i++) dba_delete($handle_later[$i], $id); ?> - </programlisting> - </example> + </programlisting> + </example> + </para> + </partintro> + <refentry id="function.dba-close"> + <refnamediv> + <refname>dba_close</refname> + <refpurpose>Ferme une base.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>dba_close</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_close</function> ferme le lien établi avec + la base et libère toutes les ressources de <parameter>handle</parameter>. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_close</function> ne retourne aucune valeur. + </para> + <para> + Voir aussi + <function>dba_open</function> et + <function>dba_popen</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-delete"> + <refnamediv> + <refname>dba_delete</refname> + <refpurpose>Efface une entrée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>dba_delete</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_delete</function> efface l'entrée + spécifiée par la clé <parameter>key</parameter>, + dans la base identifiée par <parameter>handle</parameter>. + </para> + <para> + <parameter>key</parameter> est la clé de l'entrée à effacer. + </para> + <para> + <parameter>handle</parameter> est un identifiant de lien, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_delete</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, si l'entrée est effacée, ou + pas effacée, respectivement. + </para> + <para> + Voir aussi + <function>dba_exists</function>, + <function>dba_fetch</function>, + <function>dba_insert</function> et + <function>dba_replace</function> + </para> + </refsect1> + </refentry> + <refentry id="function.dba-exists"> + <refnamediv> + <refname>dba_exists</refname> + <refpurpose>Vérifie qu'une clé existe.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_exists</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_exists</function> vérifie si la clé + <parameter>key</parameter> existe dans la base identifiée + par <parameter>handle</parameter>. + </para> + <para> + <parameter>key</parameter> est la clé qui doit être + vérifiée. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_exists</function> retourne <literal>TRUE</literal> + ou <literal>FALSE</literal>, si la clé est trouvée, + ou pas, respectivement. + </para> + <para> + Voir aussi + <function>dba_fetch</function>, + <function>dba_delete</function>, + <function>dba_insert</function> et + <function>dba_replace</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-fetch"> + <refnamediv> + <refname>dba_fetch</refname> + <refpurpose>Lit les données liées à une clé.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_fetch</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_fetch</function> lit les données spécifiée + par la clé <parameter>key</parameter> dans la base identifiée + par <parameter>handle</parameter>. + </para> + <para> + <parameter>key</parameter> est la clé dont on veut lire les + données. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_fetch</function> retourne la chaîne associée ou + <literal>FALSE</literal>, si la paire clé/valeur n'a pas été + trouvée. + </para> + <para> + Voir aussi + <function>dba_exists</function>, + <function>dba_delete</function>, + <function>dba_insert</function> et + <function>dba_replace</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-firstkey"> + <refnamediv> + <refname>dba_firstkey</refname> + <refpurpose>Lit la première clé.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_firstkey</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_firstkey</function> retourne la première clé + de la base de données spécifiée par + <parameter>handle</parameter> et y place le pointeur interne de + clé. Cela permettra de traverser la base. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_firstkey</function> retourne la clé, ou <literal>FALSE</literal>, + suivant que la première clé existe ou pas. + </para> + <para> + Voir aussi + <function>dba_nextkey</function> + et l'exemple 2 de <link linkend="ref.dba">l'introduction DBA</link>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-insert"> + <refnamediv> + <refname>dba_insert</refname> + <refpurpose>Insère une entrée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_insert</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_insert</function> insère l'entrée décrite + par la clé <parameter>key</parameter> et la valeur + <parameter>value</parameter> dans la base spécifiée + par <parameter>handle</parameter>. Si une entrée aveec la même + clé <parameter>key</parameter> existe déjà, l'insertion + échouera. + </para> + <para> + <parameter>key</parameter> est la clé de la valeur à + insérer. + </para> + <para> + <parameter>value</parameter> est la valeur à insérer. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_insert</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, suivant que l'insertion a réussi ou + échoué. + </para> + <para> + Voir aussi + <function>dba_exists</function>, + <function>dba_delete</function>, + <function>dba_fetch</function> et + <function>dba_replace</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-nextkey"> + <refnamediv> + <refname>dba_nextkey</refname> + <refpurpose>Lit la clé suivante.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_nextkey</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_nextkey</function> retourne la clé suivante, + dans la base identifiée par <parameter>handle</parameter> et + incrémente le pointeur de clé. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_nextkey</function> retourne la clé, ou + <literal>FALSE</literal> en cas d'échec. + </para> + <para> + Voir aussi + <function>dba_firstkey</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-popen"> + <refnamediv> + <refname>dba_popen</refname> + <refpurpose>Ouvre une connexion persistante à une base de données.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>dba_popen</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + <paramdef>string <parameter>handler</parameter></paramdef> + <paramdef>mixed <parameter><optional>...</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_popen</function> établit une connexion persistante + à la base repérée par <parameter>path</parameter> + avec le mode <parameter>mode</parameter>, en utilisant l'identifiant + <parameter>handler</parameter>. + </para> + <para> + <parameter>path</parameter> est le chemin sur votre machine. + </para> + <para> + <parameter>mode</parameter> vaut "r" pour lecture seule, "w" pour + lecture/écriture, "c" pour lecture/écriture, et + création si la base n'existe pas, et "n" pour + création, écrasement, et accès en + lecture/écriture. + </para> + <para> + <parameter>handler</parameter> est le nom de l'identifiant qui sera + utilisé pour accéder à <parameter>path</parameter>. + Il est passé à <function>dba_popen</function>. + </para> + <para> + <function>dba_popen</function> retourne un identifiant positif, + ou <literal>FALSE</literal>, suivant que la base a été ouverte, ou que + l'accès a échoué. + </para> + <para> + Voir aussi + <function>dba_open</function> et + <function>dba_close</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-open"> + <refnamediv> + <refname>dba_open</refname> + <refpurpose>Ouvre une base de données.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>dba_open</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + <paramdef>string <parameter>handler</parameter></paramdef> + <paramdef>mixed <parameter><optional>...</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_open</function> établit une connexion à + la base repérée par <parameter>path</parameter> avec le + mode <parameter>mode</parameter> et l'identifiant <parameter>handler</parameter>. + </para> + <para> + <parameter>path</parameter>est le chemin sur votre machine. + </para> + <para> + <parameter>mode</parameter> vaut "r" pour lecture seule, "w" pour + lecture/écriture, "c" pour lecture/écriture, et + création si la base n'existe pas, et "n" pour + création, écrasement, et accès en + lecture/écriture. + </para> + <para> + <parameter>handler</parameter> est le nom de l'identifiant qui + sera utilisé pour accéder à <parameter>path</parameter>. + Il est passé à <function>dba_popen</function>. + </para> + <para> + Voir aussi + <function>dba_popen</function> et + <function>dba_close</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-optimize"> + <refnamediv> + <refname>dba_optimize</refname> + <refpurpose>Optimise une base.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_optimize</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_optimize</function> optimise la base de données + identifiée par <parameter>handle</parameter>. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_optimize</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, suivant que l'optimisation a réussi + ou échoué. + </para> + <para> + Voir aussi + <function>dba_sync</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-replace"> + <refnamediv> + <refname>dba_replace</refname> + <refpurpose>Remplace ou insère une entrée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_replace</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_replace</function> remplaces ou insère une entrée, + pour la clé <parameter>key</parameter> et avec la valeur + <parameter>value</parameter> dans la base identifiée par + <parameter>handle</parameter>. + </para> + <para> + <parameter>key</parameter> est la clé qui va être + insérée. + </para> + <para> + <parameter>value</parameter> est la valeur qui va être + insérée. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_replace</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, suivant que l'opération réussit + ou échoue. + </para> + <para> + Voir aussi + <function>dba_exists</function>, + <function>dba_delete</function>, + <function>dba_fetch</function> et + <function>dba_insert</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-sync"> + <refnamediv> + <refname>dba_sync</refname> + <refpurpose>Synchronise une base de données.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_sync</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_sync</function> synchronise la base de données + spécifiée par <parameter>handle</parameter>. Si + accepté, cela va probablement lancer une opération + de réécriture physique du fichier. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_sync</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, si la synchronisation réussi, ou + échoue, respectivement. + </para> + <para> + Voir aussi + <function>dba_optimize</function>. </para> - </partintro> - <refentry id="function.dba-close"> - <refnamediv> - <refname>dba_close</refname> - <refpurpose>Ferme une base.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>dba_close</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_close</function> ferme le lien établit avec - la base et libère toutes les ressources de <parameter>handle</parameter>. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_close</function> ne retourne aucune valeur. - </para> - <para> - Voir aussi: <function>dba_open</function> et <function>dba_popen</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-delete"> - <refnamediv> - <refname>dba_delete</refname> - <refpurpose>Efface une entrée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_delete</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_delete</function> efface l'entrée - spécifiée par la clé <parameter>key</parameter>, - dans la base identifiée par <parameter>handle</parameter>. - </para> - <para> - <parameter>key</parameter> est la clé de l'entrée à effacer. - </para> - <para> - <parameter>handle</parameter> est un identifiant de lien, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_delete</function> retourne &true; ou &false;, si l'entrée est - effacée, ou pas effacée, respectivement. - </para> - <para> - Voir aussi: <function>dba_exists</function>, <function>dba_fetch</function>, - <function>dba_insert</function> et <function>dba_replace</function> - </para> - </refsect1> - </refentry> - <refentry id="function.dba-exists"> - <refnamediv> - <refname>dba_exists</refname> - <refpurpose>Vérifie qu'une clé existe.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_exists</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_exists</function> vérifie si la clé - <parameter>key</parameter> existe dans la base identifiée - par <parameter>handle</parameter>. - </para> - <para> - <parameter>key</parameter> est la clé qui doit être - vérfiée. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_exists</function> retourne &true; ou &false;, si la clé est - trouvée, ou pas, respectivement. - </para> - <para> - Voir aussi : <function>dba_fetch</function>, <function>dba_delete</function>, - <function>dba_insert</function> et <function>dba_replace</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-fetch"> - <refnamediv> - <refname>dba_fetch</refname> - <refpurpose>Lit les données liées à une clé.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dba_fetch</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_fetch</function> lit les données spécifiée - par la clé <parameter>key</parameter> dans la base identifiée - par <parameter>handle</parameter>. - </para> - <para> - <parameter>key</parameter> est la clé dont on veut lire les - données. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_fetch</function> retourne la chaîne associée ou &false;, - si la paire clé/valeur n'a pas été trouvée. - </para> - <para> - Voir aussi : <function>dba_exists</function>, <function>dba_delete</function>, - <function>dba_insert</function> et <function>dba_replace</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-firstkey"> - <refnamediv> - <refname>dba_firstkey</refname> - <refpurpose>Lit la première clé.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dba_firstkey</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_firstkey</function> retourne la première clé - de la base de données spécifiée par - <parameter>handle</parameter> et y place le pointeur interne de - clé. Cela permettra de traverser la base. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_firstkey</function> retourne la clé, ou &false;, suivant - que la première clé existe ou pas. - </para> - <para> - Voir aussi : <function>dba_nextkey</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-insert"> - <refnamediv> - <refname>dba_insert</refname> - <refpurpose>Insère une entrée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_insert</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>string <parameter>value</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_insert</function> insère l'entrée décrite - par la clé <parameter>key</parameter> et la valeur - <parameter>value</parameter> dans la base spécifiée - par <parameter>handle</parameter>. Si une entrée aveec la même - clé <parameter>key</parameter> existe déjà, l'insertion - échouera. - </para> - <para> - <parameter>key</parameter> est la clé de la valeur à - insérer. - </para> - <para> - <parameter>value</parameter> est la valeur à insérer. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_insert</function> retourne &true; ou &false;, suivant que l'insertion - a réussi ou échoué. - </para> - <para> - Voir aussi : <function>dba_exists</function>, <function>dba_delete</function>, - <function>dba_fetch</function> et <function>dba_replace</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-nextkey"> - <refnamediv> - <refname>dba_nextkey</refname> - <refpurpose>Lit la clé suivante.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dba_nextkey</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_nextkey</function> retourne la clé suivante, - dans la base identifiée par <parameter>handle</parameter> et - incrémente le pointeur de clé. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_nextkey</function> retourne la clé, ou &false; en cas d'échec. - </para> - <para> - Voir aussi: <function>dba_firstkey</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-popen"> - <refnamediv> - <refname>dba_popen</refname> - <refpurpose>Ouvre une connexion persistante à une base de données.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>dba_popen</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - <paramdef>string <parameter>handler</parameter></paramdef> - <paramdef><parameter><optional>...</optional></parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_popen</function> établit une connexion persistante - à la base repérée par <parameter>path</parameter> - avec le mode <parameter>mode</parameter>, en utilisant l'identifiant - <parameter>handler</parameter>. - </para> - <para> - <parameter>path</parameter> est le chemin sur votre machine. - </para> - <para> - <parameter>mode</parameter> vaut "r" pour lecture seule, "w" pour - lecture/écriture, "c" pour lecture/écriture, et - création si la base n'existe pas, et "n" pour - création, écrasement, et accès en - lecture/écriture. - </para> - <para> - <parameter>handler</parameter> est le nom de l'identifiant qui sera - utilisé pour accéder à <parameter>path</parameter>. - Il est passé à <function>dba_popen</function>. - </para> - <para> - <function>dba_popen</function> retourne un identifiant positif, - ou &false;, suivant que la base a été ouverte, ou que - l'accès a échoué. - </para> - <para> - Voir aussi : <function>dba_open</function> et <function>dba_close</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-open"> - <refnamediv> - <refname>dba_open</refname> - <refpurpose>Ouvre une base de données.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>dba_open</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - <paramdef>string <parameter>handler</parameter></paramdef> - <paramdef><parameter><optional>...</optional></parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_open</function> établit une connexion à - la base repérée par <parameter>path</parameter> avec le - mode <parameter>mode</parameter> et l'identifiant <parameter>handler</parameter>. - </para> - <para> - <parameter>path</parameter>est le chemin sur votre machine. - </para> - <para> - <parameter>mode</parameter> vaut "r" pour lecture seule, "w" pour - lecture/écriture, "c" pour lecture/écriture, et - création si la base n'existe pas, et "n" pour - création, écrasement, et accès en - lecture/écriture. - </para> - <para> - <parameter>handler</parameter> est le nom de l'identifiant qui - sera utilisé pour accéder à <parameter>path</parameter>. - Il est passé à <function>dba_popen</function>. - </para> - <para> - Voir aussi : <function>dba_popen</function> et <function>dba_close</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-optimize"> - <refnamediv> - <refname>dba_optimize</refname> - <refpurpose>Optimise une base.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_optimize</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_optimize</function> optimise la base de données - identifiée par <parameter>handle</parameter>. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_optimize</function> retourne &true; ou &false;, suivant que - l'optimisation a réussi ou échoué. - </para> - <para> - Voir aussi : <function>dba_sync</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-replace"> - <refnamediv> - <refname>dba_replace</refname> - <refpurpose>Remplace ou insère une entrée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_replace</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>string <parameter>value</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_replace</function> remplaces ou insère une entrée, - pour la clé <parameter>key</parameter> et avec la valeur - <parameter>value</parameter> dans la base identifiée par - <parameter>handle</parameter>. - </para> - <para> - <parameter>key</parameter> est la clé qui va être - insérée. - </para> - <para> - <parameter>value</parameter> est la valeur qui va être - insérée. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_replace</function> retourne &true; ou &false;, suivant que - l'opération réussit ou échoue. - </para> - <para> - Voir aussi : <function>dba_exists</function>, <function>dba_delete</function>, - <function>dba_fetch</function> et <function>dba_insert</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-sync"> - <refnamediv> - <refname>dba_sync</refname> - <refpurpose>Synchronise une base de données.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_sync</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_sync</function> synchronise la base de données - spécifiée par <parameter>handle</parameter>. Si - accepté, cela va probablement lancer une opération - de réécriture physique du fichier. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_sync</function> retourne &true; ou &false;, si la - synchronisation réussi, ou échoue, respectivement. - </para> - <para> - Voir aussi : <function>dba_optimize</function>. - </para> - </refsect1> - </refentry> - </reference> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/dba.xml diff -u phpdoc/fr/functions/dba.xml:1.9 phpdoc/fr/functions/dba.xml:1.10 --- phpdoc/fr/functions/dba.xml:1.9 Sat Jul 7 18:22:05 2001 +++ phpdoc/fr/functions/dba.xml Tue Jul 31 03:35:49 2001 @@ -1,81 +1,108 @@ - <reference id="ref.dba"> - <title>DBA</title> - <titleabbrev>DBA</titleabbrev> - <partintro> - <para> - Ces fonctions sont l'interface avec les bases de type Berkeley. - </para> - <para> - C'est une couche générale pour plusieurs bases de - données sur fichiers. En tant que tel, les fonctionnalités - sont limitées à une partie des fonctionnalités des - bases de données modernes, comme - <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink>. (A ne pas confondre avec - IBM's DB2 software, qui fonctionne avec <link linkend="ref.odbc">ODBC</link>.). - </para> - <para> - Le comportement de certaines fonctions dépends de la base de - données utilisée. Par exemple - <function>dba_optimize</function> et <function>dba_sync</function> - n'auront pas le même effet d'une base à l'autre. - </para> - <para> - Pour ajouter le support d'une base dba, il suffit d'ajouter l'option - de configuration --with adéquate. Les bases suivantes sont supportées : - <itemizedlist> - <listitem> - <simpara> - Dbm est la plus ancienne des base de données de type Berkeley. - Il vaut mieux l'éviter si possible. Les fonctions de - compatibilités codées dans DB2 et gdbm - ne sont pas supportées, car elles ne sont compatibles qu'au - niveau du code source, et ne peuvent pas gérer le format dbm originel. - (<link linkend="install.configure.with-dbm">--with-dbm</link>). - </simpara> - </listitem> - <listitem> - <simpara> - ndbm est un nouveau type de dbm plus flexible. Il a cependant - la majorité des limitations du genre. - (<link linkend="install.configure.with-ndbm">--with-ndbm</link>). - </simpara> - </listitem> - <listitem> - <simpara> - gdbm est <ulink url="">la base dbm GNU</ulink>. - (<link linkend="install.configure.with-gdbm">--with-gdbm</link>). - </simpara> - </listitem> - <listitem> - <simpara> - db2 est <ulink url="&url.sleepycat;">DB2 de Sleepycat Software</ulink>. Elle se - décrit comme un "ensemble d'outils qui fournissent une base - de données performante, tant pour les applications - indépendantes que pour le client/serveur". - (<link linkend="install.configure.with-db2">--with-db2</link>). - </simpara> - </listitem> - <listitem> - <simpara> - DB3 est le <ulink url="&url.sleepycat;">DB3 de Sleepycat Software</ulink>. - (<link linkend="install.configure.with-db3">--with-db3</link>). - </simpara> - </listitem> - <listitem> - <simpara> - cdb est "un package rapide, robuste, léger, pour créer et - lire des bases de données constantes". C'est l'auteur de qmail qui - l'a écrit, et elle est disponible <ulink url="">ici</ulink>. Puisque - c'est une base constante, elle ne supporte que la lecture. - (<link linkend="install.configure.with-cdb">--with-cdb</link>). - </simpara> - </listitem> - </itemizedlist> +<reference id="ref.dba"> + <title>DBA</title> + <titleabbrev>DBA</titleabbrev> + <partintro> + <para> + Ces fonctions sont l'interface avec les bases de type Berkeley. + </para> + <para> + C'est une couche générale pour plusieurs bases de + données sur fichiers. En tant que tel, les fonctionnalités + sont limitées à une partie des fonctionnalités des + bases de données modernes, comme + <ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink> (A ne pas confondre avec + IBM's DB2 software, qui fonctionne avec <link linkend="ref.odbc">ODBC</link>). + </para> + <para> + Le comportement de certaines fonctions dépends de la base de + données utilisée. Par exemple + <function>dba_optimize</function> et <function>dba_sync</function> + n'auront pas le même effet d'une base à l'autre. + </para> + <para> + Lors de l'utilisation de la fonction <function>dba_open</function> ou de + <function>dba_popen</function>, une des librairies suivante doit + être fournie comme argument. La liste complète des librairies + supportées par votre configuration est disponible avec la fonction + <function>phpinfo</function>. (Pour ajouter le support de l'une + de ces librairies, ajouter l'option de configuration + <literal>--with-XXXX</literal>). + <table> + <title>Liste des librairies DBA</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Librairie</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>dbm</literal></entry> + <entry> + Dbm est la plus ancienne des base de données de type Berkeley. + Il vaut mieux l'éviter si possible. Les fonctions de + compatibilités codées dans DB2 et gdbm + ne sont pas supportées, car elles ne sont compatibles qu'au + niveau du code source, et ne peuvent pas gérer le format dbm originel. + (<link linkend="install.configure.with-dbm"><option role="configure"> + --with-dbm</option></link>). + </entry> + </row> + <row> + <entry><literal>ndbm</literal></entry> + <entry> + ndbm est un nouveau type de dbm plus flexible. Il a cependant + la majorité des limitations du genre. + (<link linkend="install.configure.with-ndbm"><option role="configure"> + --with-ndbm</option></link>). + </entry> + </row> + <row> + <entry><literal>gdbm</literal></entry> + <entry> + gdbm est <ulink url="&url.gdbm;">la base dbm GNU</ulink>. + (<link linkend="install.configure.with-gdbm"><option role="configure"> + --with-gdbm</option></link>). + </entry> + </row> + <row> + <entry><literal>db2</literal></entry> + <entry> + db2 est <ulink url="&url.sleepycat;">DB2 de Sleepycat Software</ulink>. Elle se + décrit comme un "ensemble d'outils qui fournissent une base + de données performante, tant pour les applications + indépendantes que pour le client/serveur". + (<link linkend="install.configure.with-db2"><option role="configure"> + --with-db2</option></link>). + </entry> + </row> + <row> + <entry><literal>db3</literal></entry> + <entry> + DB3 est le <ulink url="&url.sleepycat;">DB3 de Sleepycat Software</ulink>. + (<link linkend="install.configure.with-db3"><option role="configure"> + --with-db3</option></link>). + </entry> + </row> + <row> + <entry><literal>cdb</literal></entry> + <entry> + cdb est "un package rapide, robuste, léger, pour créer et + lire des bases de données constantes". C'est l'auteur de qmail qui + l'a écrit, et elle est disponible <ulink url="&url.cdb;">ici</ulink>. Puisque + c'est une base constante, elle ne supporte que la lecture. + (<link linkend="install.configure.with-cdb">--with-cdb</link>). + </entry> + </row> + </tbody> + </tgroup> + </table> </para> <para> <example> <title>Exemple DBA</title> - <programlisting role="php"> + <programlisting role="php"> <?php $id = dba_open("/tmp/test.db", "n", "db2"); if(!$id) { @@ -89,30 +116,30 @@ } dba_close($id); ?> - </programlisting> - </example> - </para> - <para> - DBA gère les données binaires, et n'a pas de limites arbitraires. - Elle hérite de toutes les limites de la base sous jacentes. - </para> - <para> - Toutes les bases de données sur fichiers doivent fournir un moyen - de changer le mode d'accès au fichier d'une base, et si possible, - de toutes les bases. Le mode d'accès est généralement - passé en 4ème argument à <function>dba_open</function> - ou <function>dba_popen</function>. - </para> - <para> - Vous pouvez accéder à toutes les entrées d'une - base d'une manière linéaire, avec les fonctions - <function>dba_firstkey</function> et <function>dba_nextkey</function>. - Vous ne devez pas modifier une base lorsque vous la traversez ainsi. - </para> - <para> - <example> - <title>Passer en revue une base</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + DBA gère les données binaires, et n'a pas de limites arbitraires. + Elle hérite de toutes les limites de la base sous jacentes. + </para> + <para> + Toutes les bases de données sur fichiers doivent fournir un moyen + de changer le mode d'accès au fichier d'une base, et si possible, + de toutes les bases. Le mode d'accès est généralement + passé en 4ème argument à <function>dba_open</function> + ou <function>dba_popen</function>. + </para> + <para> + Vous pouvez accéder à toutes les entrées d'une + base d'une manière linéaire, avec les fonctions + <function>dba_firstkey</function> et <function>dba_nextkey</function>. + Vous ne devez pas modifier une base lorsque vous la traversez ainsi. + </para> + <para> + <example> + <title>Passer en revue une base</title> + <programlisting role="php"> <?php # ...ouverture de la base... $key = dba_firstkey($id); @@ -125,449 +152,483 @@ for($i = 0; $i < count($handle_later); $i++) dba_delete($handle_later[$i], $id); ?> - </programlisting> - </example> + </programlisting> + </example> + </para> + </partintro> + <refentry id="function.dba-close"> + <refnamediv> + <refname>dba_close</refname> + <refpurpose>Ferme une base.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>dba_close</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_close</function> ferme le lien établi avec + la base et libère toutes les ressources de <parameter>handle</parameter>. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_close</function> ne retourne aucune valeur. + </para> + <para> + Voir aussi + <function>dba_open</function> et + <function>dba_popen</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-delete"> + <refnamediv> + <refname>dba_delete</refname> + <refpurpose>Efface une entrée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>dba_delete</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_delete</function> efface l'entrée + spécifiée par la clé <parameter>key</parameter>, + dans la base identifiée par <parameter>handle</parameter>. + </para> + <para> + <parameter>key</parameter> est la clé de l'entrée à effacer. + </para> + <para> + <parameter>handle</parameter> est un identifiant de lien, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_delete</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, si l'entrée est effacée, ou + pas effacée, respectivement. + </para> + <para> + Voir aussi + <function>dba_exists</function>, + <function>dba_fetch</function>, + <function>dba_insert</function> et + <function>dba_replace</function> + </para> + </refsect1> + </refentry> + <refentry id="function.dba-exists"> + <refnamediv> + <refname>dba_exists</refname> + <refpurpose>Vérifie qu'une clé existe.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_exists</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_exists</function> vérifie si la clé + <parameter>key</parameter> existe dans la base identifiée + par <parameter>handle</parameter>. + </para> + <para> + <parameter>key</parameter> est la clé qui doit être + vérifiée. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_exists</function> retourne <literal>TRUE</literal> + ou <literal>FALSE</literal>, si la clé est trouvée, + ou pas, respectivement. + </para> + <para> + Voir aussi + <function>dba_fetch</function>, + <function>dba_delete</function>, + <function>dba_insert</function> et + <function>dba_replace</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-fetch"> + <refnamediv> + <refname>dba_fetch</refname> + <refpurpose>Lit les données liées à une clé.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_fetch</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_fetch</function> lit les données spécifiée + par la clé <parameter>key</parameter> dans la base identifiée + par <parameter>handle</parameter>. + </para> + <para> + <parameter>key</parameter> est la clé dont on veut lire les + données. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_fetch</function> retourne la chaîne associée ou + <literal>FALSE</literal>, si la paire clé/valeur n'a pas été + trouvée. + </para> + <para> + Voir aussi + <function>dba_exists</function>, + <function>dba_delete</function>, + <function>dba_insert</function> et + <function>dba_replace</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-firstkey"> + <refnamediv> + <refname>dba_firstkey</refname> + <refpurpose>Lit la première clé.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_firstkey</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_firstkey</function> retourne la première clé + de la base de données spécifiée par + <parameter>handle</parameter> et y place le pointeur interne de + clé. Cela permettra de traverser la base. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_firstkey</function> retourne la clé, ou <literal>FALSE</literal>, + suivant que la première clé existe ou pas. + </para> + <para> + Voir aussi + <function>dba_nextkey</function> + et l'exemple 2 de <link linkend="ref.dba">l'introduction DBA</link>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-insert"> + <refnamediv> + <refname>dba_insert</refname> + <refpurpose>Insère une entrée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_insert</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_insert</function> insère l'entrée décrite + par la clé <parameter>key</parameter> et la valeur + <parameter>value</parameter> dans la base spécifiée + par <parameter>handle</parameter>. Si une entrée aveec la même + clé <parameter>key</parameter> existe déjà, l'insertion + échouera. + </para> + <para> + <parameter>key</parameter> est la clé de la valeur à + insérer. + </para> + <para> + <parameter>value</parameter> est la valeur à insérer. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_insert</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, suivant que l'insertion a réussi ou + échoué. + </para> + <para> + Voir aussi + <function>dba_exists</function>, + <function>dba_delete</function>, + <function>dba_fetch</function> et + <function>dba_replace</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-nextkey"> + <refnamediv> + <refname>dba_nextkey</refname> + <refpurpose>Lit la clé suivante.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dba_nextkey</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_nextkey</function> retourne la clé suivante, + dans la base identifiée par <parameter>handle</parameter> et + incrémente le pointeur de clé. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base, retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_nextkey</function> retourne la clé, ou + <literal>FALSE</literal> en cas d'échec. + </para> + <para> + Voir aussi + <function>dba_firstkey</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-popen"> + <refnamediv> + <refname>dba_popen</refname> + <refpurpose>Ouvre une connexion persistante à une base de données.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>dba_popen</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + <paramdef>string <parameter>handler</parameter></paramdef> + <paramdef>mixed <parameter><optional>...</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_popen</function> établit une connexion persistante + à la base repérée par <parameter>path</parameter> + avec le mode <parameter>mode</parameter>, en utilisant l'identifiant + <parameter>handler</parameter>. + </para> + <para> + <parameter>path</parameter> est le chemin sur votre machine. + </para> + <para> + <parameter>mode</parameter> vaut "r" pour lecture seule, "w" pour + lecture/écriture, "c" pour lecture/écriture, et + création si la base n'existe pas, et "n" pour + création, écrasement, et accès en + lecture/écriture. + </para> + <para> + <parameter>handler</parameter> est le nom de l'identifiant qui sera + utilisé pour accéder à <parameter>path</parameter>. + Il est passé à <function>dba_popen</function>. + </para> + <para> + <function>dba_popen</function> retourne un identifiant positif, + ou <literal>FALSE</literal>, suivant que la base a été ouverte, ou que + l'accès a échoué. + </para> + <para> + Voir aussi + <function>dba_open</function> et + <function>dba_close</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-open"> + <refnamediv> + <refname>dba_open</refname> + <refpurpose>Ouvre une base de données.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>dba_open</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + <paramdef>string <parameter>handler</parameter></paramdef> + <paramdef>mixed <parameter><optional>...</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_open</function> établit une connexion à + la base repérée par <parameter>path</parameter> avec le + mode <parameter>mode</parameter> et l'identifiant <parameter>handler</parameter>. + </para> + <para> + <parameter>path</parameter>est le chemin sur votre machine. + </para> + <para> + <parameter>mode</parameter> vaut "r" pour lecture seule, "w" pour + lecture/écriture, "c" pour lecture/écriture, et + création si la base n'existe pas, et "n" pour + création, écrasement, et accès en + lecture/écriture. + </para> + <para> + <parameter>handler</parameter> est le nom de l'identifiant qui + sera utilisé pour accéder à <parameter>path</parameter>. + Il est passé à <function>dba_popen</function>. + </para> + <para> + Voir aussi + <function>dba_popen</function> et + <function>dba_close</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-optimize"> + <refnamediv> + <refname>dba_optimize</refname> + <refpurpose>Optimise une base.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_optimize</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_optimize</function> optimise la base de données + identifiée par <parameter>handle</parameter>. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_optimize</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, suivant que l'optimisation a réussi + ou échoué. + </para> + <para> + Voir aussi + <function>dba_sync</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-replace"> + <refnamediv> + <refname>dba_replace</refname> + <refpurpose>Remplace ou insère une entrée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_replace</function></funcdef> + <paramdef>string <parameter>key</parameter></paramdef> + <paramdef>string <parameter>value</parameter></paramdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_replace</function> remplaces ou insère une entrée, + pour la clé <parameter>key</parameter> et avec la valeur + <parameter>value</parameter> dans la base identifiée par + <parameter>handle</parameter>. + </para> + <para> + <parameter>key</parameter> est la clé qui va être + insérée. + </para> + <para> + <parameter>value</parameter> est la valeur qui va être + insérée. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_replace</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, suivant que l'opération réussit + ou échoue. + </para> + <para> + Voir aussi + <function>dba_exists</function>, + <function>dba_delete</function>, + <function>dba_fetch</function> et + <function>dba_insert</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dba-sync"> + <refnamediv> + <refname>dba_sync</refname> + <refpurpose>Synchronise une base de données.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dba_sync</function></funcdef> + <paramdef>resource <parameter>handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dba_sync</function> synchronise la base de données + spécifiée par <parameter>handle</parameter>. Si + accepté, cela va probablement lancer une opération + de réécriture physique du fichier. + </para> + <para> + <parameter>handle</parameter> est un identifiant de base retourné par + <function>dba_open</function>. + </para> + <para> + <function>dba_sync</function> retourne <literal>TRUE</literal> ou + <literal>FALSE</literal>, si la synchronisation réussi, ou + échoue, respectivement. + </para> + <para> + Voir aussi + <function>dba_optimize</function>. </para> - </partintro> - <refentry id="function.dba-close"> - <refnamediv> - <refname>dba_close</refname> - <refpurpose>Ferme une base.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>dba_close</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_close</function> ferme le lien établit avec - la base et libère toutes les ressources de <parameter>handle</parameter>. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_close</function> ne retourne aucune valeur. - </para> - <para> - Voir aussi: <function>dba_open</function> et <function>dba_popen</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-delete"> - <refnamediv> - <refname>dba_delete</refname> - <refpurpose>Efface une entrée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_delete</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_delete</function> efface l'entrée - spécifiée par la clé <parameter>key</parameter>, - dans la base identifiée par <parameter>handle</parameter>. - </para> - <para> - <parameter>key</parameter> est la clé de l'entrée à effacer. - </para> - <para> - <parameter>handle</parameter> est un identifiant de lien, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_delete</function> retourne &true; ou &false;, si l'entrée est - effacée, ou pas effacée, respectivement. - </para> - <para> - Voir aussi: <function>dba_exists</function>, <function>dba_fetch</function>, - <function>dba_insert</function> et <function>dba_replace</function> - </para> - </refsect1> - </refentry> - <refentry id="function.dba-exists"> - <refnamediv> - <refname>dba_exists</refname> - <refpurpose>Vérifie qu'une clé existe.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_exists</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_exists</function> vérifie si la clé - <parameter>key</parameter> existe dans la base identifiée - par <parameter>handle</parameter>. - </para> - <para> - <parameter>key</parameter> est la clé qui doit être - vérfiée. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_exists</function> retourne &true; ou &false;, si la clé est - trouvée, ou pas, respectivement. - </para> - <para> - Voir aussi : <function>dba_fetch</function>, <function>dba_delete</function>, - <function>dba_insert</function> et <function>dba_replace</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-fetch"> - <refnamediv> - <refname>dba_fetch</refname> - <refpurpose>Lit les données liées à une clé.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dba_fetch</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_fetch</function> lit les données spécifiée - par la clé <parameter>key</parameter> dans la base identifiée - par <parameter>handle</parameter>. - </para> - <para> - <parameter>key</parameter> est la clé dont on veut lire les - données. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_fetch</function> retourne la chaîne associée ou &false;, - si la paire clé/valeur n'a pas été trouvée. - </para> - <para> - Voir aussi : <function>dba_exists</function>, <function>dba_delete</function>, - <function>dba_insert</function> et <function>dba_replace</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-firstkey"> - <refnamediv> - <refname>dba_firstkey</refname> - <refpurpose>Lit la première clé.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dba_firstkey</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_firstkey</function> retourne la première clé - de la base de données spécifiée par - <parameter>handle</parameter> et y place le pointeur interne de - clé. Cela permettra de traverser la base. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_firstkey</function> retourne la clé, ou &false;, suivant - que la première clé existe ou pas. - </para> - <para> - Voir aussi : <function>dba_nextkey</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-insert"> - <refnamediv> - <refname>dba_insert</refname> - <refpurpose>Insère une entrée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_insert</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>string <parameter>value</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_insert</function> insère l'entrée décrite - par la clé <parameter>key</parameter> et la valeur - <parameter>value</parameter> dans la base spécifiée - par <parameter>handle</parameter>. Si une entrée aveec la même - clé <parameter>key</parameter> existe déjà, l'insertion - échouera. - </para> - <para> - <parameter>key</parameter> est la clé de la valeur à - insérer. - </para> - <para> - <parameter>value</parameter> est la valeur à insérer. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_insert</function> retourne &true; ou &false;, suivant que l'insertion - a réussi ou échoué. - </para> - <para> - Voir aussi : <function>dba_exists</function>, <function>dba_delete</function>, - <function>dba_fetch</function> et <function>dba_replace</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-nextkey"> - <refnamediv> - <refname>dba_nextkey</refname> - <refpurpose>Lit la clé suivante.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dba_nextkey</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_nextkey</function> retourne la clé suivante, - dans la base identifiée par <parameter>handle</parameter> et - incrémente le pointeur de clé. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base, retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_nextkey</function> retourne la clé, ou &false; en cas d'échec. - </para> - <para> - Voir aussi: <function>dba_firstkey</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-popen"> - <refnamediv> - <refname>dba_popen</refname> - <refpurpose>Ouvre une connexion persistante à une base de données.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>dba_popen</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - <paramdef>string <parameter>handler</parameter></paramdef> - <paramdef><parameter><optional>...</optional></parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_popen</function> établit une connexion persistante - à la base repérée par <parameter>path</parameter> - avec le mode <parameter>mode</parameter>, en utilisant l'identifiant - <parameter>handler</parameter>. - </para> - <para> - <parameter>path</parameter> est le chemin sur votre machine. - </para> - <para> - <parameter>mode</parameter> vaut "r" pour lecture seule, "w" pour - lecture/écriture, "c" pour lecture/écriture, et - création si la base n'existe pas, et "n" pour - création, écrasement, et accès en - lecture/écriture. - </para> - <para> - <parameter>handler</parameter> est le nom de l'identifiant qui sera - utilisé pour accéder à <parameter>path</parameter>. - Il est passé à <function>dba_popen</function>. - </para> - <para> - <function>dba_popen</function> retourne un identifiant positif, - ou &false;, suivant que la base a été ouverte, ou que - l'accès a échoué. - </para> - <para> - Voir aussi : <function>dba_open</function> et <function>dba_close</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-open"> - <refnamediv> - <refname>dba_open</refname> - <refpurpose>Ouvre une base de données.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>dba_open</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - <paramdef>string <parameter>handler</parameter></paramdef> - <paramdef><parameter><optional>...</optional></parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_open</function> établit une connexion à - la base repérée par <parameter>path</parameter> avec le - mode <parameter>mode</parameter> et l'identifiant <parameter>handler</parameter>. - </para> - <para> - <parameter>path</parameter>est le chemin sur votre machine. - </para> - <para> - <parameter>mode</parameter> vaut "r" pour lecture seule, "w" pour - lecture/écriture, "c" pour lecture/écriture, et - création si la base n'existe pas, et "n" pour - création, écrasement, et accès en - lecture/écriture. - </para> - <para> - <parameter>handler</parameter> est le nom de l'identifiant qui - sera utilisé pour accéder à <parameter>path</parameter>. - Il est passé à <function>dba_popen</function>. - </para> - <para> - Voir aussi : <function>dba_popen</function> et <function>dba_close</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-optimize"> - <refnamediv> - <refname>dba_optimize</refname> - <refpurpose>Optimise une base.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_optimize</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_optimize</function> optimise la base de données - identifiée par <parameter>handle</parameter>. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_optimize</function> retourne &true; ou &false;, suivant que - l'optimisation a réussi ou échoué. - </para> - <para> - Voir aussi : <function>dba_sync</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-replace"> - <refnamediv> - <refname>dba_replace</refname> - <refpurpose>Remplace ou insère une entrée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_replace</function></funcdef> - <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>string <parameter>value</parameter></paramdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_replace</function> remplaces ou insère une entrée, - pour la clé <parameter>key</parameter> et avec la valeur - <parameter>value</parameter> dans la base identifiée par - <parameter>handle</parameter>. - </para> - <para> - <parameter>key</parameter> est la clé qui va être - insérée. - </para> - <para> - <parameter>value</parameter> est la valeur qui va être - insérée. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_replace</function> retourne &true; ou &false;, suivant que - l'opération réussit ou échoue. - </para> - <para> - Voir aussi : <function>dba_exists</function>, <function>dba_delete</function>, - <function>dba_fetch</function> et <function>dba_insert</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dba-sync"> - <refnamediv> - <refname>dba_sync</refname> - <refpurpose>Synchronise une base de données.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dba_sync</function></funcdef> - <paramdef>resource <parameter>handle</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dba_sync</function> synchronise la base de données - spécifiée par <parameter>handle</parameter>. Si - accepté, cela va probablement lancer une opération - de réécriture physique du fichier. - </para> - <para> - <parameter>handle</parameter> est un identifiant de base retourné par - <function>dba_open</function>. - </para> - <para> - <function>dba_sync</function> retourne &true; ou &false;, si la - synchronisation réussi, ou échoue, respectivement. - </para> - <para> - Voir aussi : <function>dba_optimize</function>. - </para> - </refsect1> - </refentry> - </reference> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml