cvs: phpdoc /fr/functions dbm.xml
| From: | Damien Seguy | Date: | Thu, 02 Aug 2001 09:53:27 +0000 |
| Subject: | cvs: phpdoc /fr/functions dbm.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336690@lists.php.net to get a copy of this message | ||
dams Thu Aug 2 05:53:27 2001 EDT
Modified files:
/phpdoc/fr/functions dbm.xml
Log:
Typos
Index: phpdoc/fr/functions/dbm.xml diff -u phpdoc/fr/functions/dbm.xml:1.5 phpdoc/fr/functions/dbm.xml:1.6 --- phpdoc/fr/functions/dbm.xml:1.5 Sat Jul 7 18:22:05 2001 +++ phpdoc/fr/functions/dbm.xml Thu Aug 2 05:53:25 2001 @@ -1,10 +1,10 @@ - <reference id="ref.dbm"> - <title>DBM</title> - <titleabbrev>DBM</titleabbrev> - <partintro> +<reference id="ref.dbm"> + <title>DBM</title> + <titleabbrev>DBM</titleabbrev> + <partintro> <simpara> Ces fonctions vous permettent d'écrire des lignes dans une - base de donnée de type dbm. Ce type de base (supporté + base de données de type dbm. Ce type de base (supporté par Berkeley db, gdbm, et quelques librairies systèmes, ou certaines librairies du système d'exploitation) enregistre les paires clés/valeurs, (contrairement aux enregistrements @@ -13,282 +13,282 @@ </simpara> <para> <example> - <title>dbm</title> + <title>Présentation de dbm</title> <programlisting role="php"> <?php -$dbm = dbmopen("dernier", "w"); -if (dbmexists($dbm, $userid)) { - $last_seen = dbmfetch($dbm, $userid); -} else { - dbminsert($dbm, $userid, time()); -} -faire_quelquechose(); -dbmreplace($dbm, $userid, time()); -dbmclose($dbm); + $dbm = dbmopen("dernier", "w"); + if (dbmexists($dbm, $userid)) { + $last_seen = dbmfetch($dbm, $userid); + } else { + dbminsert($dbm, $userid, time()); + } + faire_quelquechose(); + dbmreplace($dbm, $userid, time()); + dbmclose($dbm); ?> </programlisting> </example> </para> - </partintro> - <refentry id="function.dbmopen"> - <refnamediv> - <refname>dbmopen</refname> - <refpurpose>Ouvre une base de données dbm</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource <function>dbmopen</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>string <parameter>flags</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Le premier argument est le chemin absolu jusqu'au fichier dbm à - ouvrir. Le deuxième argument est le mode d'ouverture du fichier, - qui peut prendre les valeurs suivantes : "r", "n", "c" ou "w" qui - représentent respectivement lecture seule, nouveau (ce qui - implique lecture/écriture, et qui, probablement, va - écraser une base existante), création(ce qui - implique lecture/écriture, et qui, probablement, va - écraser une base existante), et lecture/écriture. - </para> - <para> - <function>dbmopen</function> retourne un identifiant, qui - sera passé à toutes les autres fonctions dbm, - en cas de succès, ou &false; en - cas d'échec. - </para> - <para> - Si ndbm est utilisé, ndbm va créer les fichiers - <filename>filename.dir</filename> et <filename>filename.pag</filename>. - gdbm n'utilise qu'un fichier, tout comme les librairies internes, - et Berkeley db crée - le fichier <filename>filename.db</filename>. Notez que PHP - dispose de son propre système de verrouillage des - fichiers, qui s'additionne à celui éventuellement - utilisé par les librairies. PHP n'efface jamais les fichiers - <filename>.lck</filename> qu'il crée. Il les utilise comme - inode fixe, sur lequel faire le verrouillage. - Pour plus d'informations sur les fichiers dbm, reportez vous - à vos pages de manuel Unix (man) , ou bien chargez gdbm : - <filename role="url">ftp://prep.ai.mit.edu/pub/gnu</filename>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmclose"> - <refnamediv> - <refname>dbmclose</refname> - <refpurpose>Ferme une base de données dbm.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dbmclose</function></funcdef> + </partintro> + <refentry id="function.dbmopen"> + <refnamediv> + <refname>dbmopen</refname> + <refpurpose>Ouvre une base de données dbm</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>dbmopen</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>string <parameter>flags</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Le premier argument est le chemin absolu jusqu'au fichier dbm à + ouvrir. Le deuxième argument est le mode d'ouverture du fichier, + qui peut prendre les valeurs suivantes : "r", "n", "c" ou "w" qui + représentent respectivement lecture seule, nouveau (ce qui + implique lecture/écriture, et qui, probablement, va + écraser une base existante), création(ce qui + implique lecture/écriture, et qui, probablement, va + écraser une base existante), et lecture/écriture. + </para> + <para> + <function>dbmopen</function> retourne un identifiant, qui + sera passé à toutes les autres fonctions dbm, + en cas de succès, ou <literal>FALSE</literal> en + cas d'échec. + </para> + <para> + Si ndbm est utilisé, ndbm va créer les fichiers + <filename>filename.dir</filename> et <filename>filename.pag</filename>. + gdbm n'utilise qu'un fichier, tout comme les librairies internes, + et Berkeley db crée + le fichier <filename>filename.db</filename>. Notez que PHP + dispose de son propre système de verrouillage des + fichiers, qui s'additionne à celui éventuellement + utilisé par les librairies. PHP n'efface jamais les fichiers + <filename>.lck</filename> qu'il crée. Il les utilise comme + inode fixe, sur lequel faire le verrouillage. + Pour plus d'informations sur les fichiers dbm, reportez-vous + à vos pages de manuel Unix (man) , ou bien chargez gdbm : + <filename role="url">ftp://prep.ai.mit.edu/pub/gnu</filename>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmclose"> + <refnamediv> + <refname>dbmclose</refname> + <refpurpose>Ferme une base de données dbm.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbmclose</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmclose</function> déverrouille et - ferme la base de données <parameter>dbm_identifier</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmexists"> - <refnamediv> - <refname>dbmexists</refname> - <refpurpose>Indique si une valeur existe.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dbmexists</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmclose</function> déverrouille et + ferme la base de données <parameter>dbm_identifier</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmexists"> + <refnamediv> + <refname>dbmexists</refname> + <refpurpose>Indique si une valeur existe.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbmexists</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmexists</function> retourne &true; - si il y a une valeur associée à la clé - <parameter>key</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmfetch"> - <refnamediv> - <refname>dbmfetch</refname> - <refpurpose>Lit une valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmexists</function> retourne <literal>TRUE</literal> + s'il y a une valeur associée à la clé + <parameter>key</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmfetch"> + <refnamediv> + <refname>dbmfetch</refname> + <refpurpose>Lit une valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>dbmfetch</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmfetch</function> retourne la valeur associée - à la clé <parameter>key</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbminsert"> - <refnamediv> - <refname>dbminsert</refname> - <refpurpose>Insère une valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmfetch</function> retourne la valeur associée + à la clé <parameter>key</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbminsert"> + <refnamediv> + <refname>dbminsert</refname> + <refpurpose>Insère une valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbminsert</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> <paramdef>string <parameter>value</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbminsert</function> ajoute la valeur - <parameter>value</parameter> dans la base de - données, avec la clé <parameter>key</parameter>. - </para> - <para> - <function>dbminsert</function> retourne -1 si la base a - été ouverte en mode lecture - seule, 0 si l'insertion a été réussie, et 1 si - la clé key existe déjà. (Pour remplacer la - valeur, utilisez <function>dbmreplace</function>.) - </para> - </refsect1> - </refentry> - <refentry id="function.dbmreplace"> - <refnamediv> - <refname>dbmreplace</refname> - <refpurpose>Remplace une valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dbmreplace</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbminsert</function> ajoute la valeur + <parameter>value</parameter> dans la base de + données, avec la clé <parameter>key</parameter>. + </para> + <para> + <function>dbminsert</function> retourne -1 si la base a + été ouverte en mode lecture + seule, 0 si l'insertion a été réussie, et 1 si + la clé key existe déjà. (Pour remplacer la + valeur, utilisez <function>dbmreplace</function>.) + </para> + </refsect1> + </refentry> + <refentry id="function.dbmreplace"> + <refnamediv> + <refname>dbmreplace</refname> + <refpurpose>Remplace une valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbmreplace</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> <paramdef>string <parameter>value</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmreplace</function> remplace la valeur courante par - la valeur <parameter>value</parameter> pour la clé - <parameter>key</parameter>, dans une base <parameter>dbm_identifier</parameter>. - </para> - <para> - <function>dbmreplace</function> crée la clé, si elle n'existe pas - dans la base. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmdelete"> - <refnamediv> - <refname>dbmdelete</refname> - <refpurpose>Efface une valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dbmdelete</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmreplace</function> remplace la valeur courante par + la valeur <parameter>value</parameter> pour la clé + <parameter>key</parameter>, dans une base <parameter>dbm_identifier</parameter>. + </para> + <para> + <function>dbmreplace</function> crée la clé, si elle n'existe pas + dans la base. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmdelete"> + <refnamediv> + <refname>dbmdelete</refname> + <refpurpose>Efface une valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbmdelete</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmdelete</function> efface la valeur de la clé - <parameter>key</parameter>, dans la base <parameter>dbm_identifier</parameter>. - </para> - <para> - <function>dbmdelete</function> retourne &false; - si la clé n'existe pas dans cette base. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmfirstkey"> - <refnamediv> - <refname>dbmfirstkey</refname> - <refpurpose>Lit la première clé.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmdelete</function> efface la valeur de la clé + <parameter>key</parameter>, dans la base <parameter>dbm_identifier</parameter>. + </para> + <para> + <function>dbmdelete</function> retourne <literal>FALSE</literal> + si la clé n'existe pas dans cette base. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmfirstkey"> + <refnamediv> + <refname>dbmfirstkey</refname> + <refpurpose>Lit la première clé.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>dbmfirstkey</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmfirstkey</function> retourne la première - clé de la base de données. Notez bien que les - clés ne sont pas dans un ordre défini, - étant donné que la table est construite comme une table - de hash. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmnextkey"> - <refnamediv> - <refname>dbmnextkey</refname> - <refpurpose>Lit la clé suivante.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dbmnextkey</function></funcdef> - <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> - <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmnextkey</function> retourne la clé après la clé - <parameter>key</parameter>. En appelant <function>dbmfirstkey</function>, - puis successivement <function>dbmnextkey</function>, il est - possible de passer en revue toute les paires clé/valeur - de la base de données dbm. Par exemple : - <example> - <title>Passer en revue une base de données.</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmfirstkey</function> retourne la première + clé de la base de données. Notez bien que les + clés ne sont pas dans un ordre défini, + étant donné que la table est construite comme un tableau + associatif. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmnextkey"> + <refnamediv> + <refname>dbmnextkey</refname> + <refpurpose>Lit la clé suivante.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dbmnextkey</function></funcdef> + <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> + <paramdef>string <parameter>key</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmnextkey</function> retourne la clé après la clé + <parameter>key</parameter>. En appelant <function>dbmfirstkey</function>, + puis successivement <function>dbmnextkey</function>, il est + possible de passer en revue toute les paires clé/valeur + de la base de données dbm. Par exemple : + <example> + <title>Passer en revue une base de données.</title> + <programlisting role="php"> <?php -$key = dbmfirstkey($dbm_id); -while ($key) { - echo "$key = " . dbmfetch($dbm_id, $key) . "\n"; - $key = dbmnextkey($dbm_id, $key); -} + $cle = dbmfirstkey($dbm_id); + while ($cle){ + echo "$cle = " . dbmfetch($dbm_id, $cle) . "\n"; + $cle = dbmnextkey($dbm_id, $cle); + } ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.dblist"> - <refnamediv> - <refname>dblist</refname> - <refpurpose>Décrit la librairie dbm utilisée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.dblist"> + <refnamediv> + <refname>dblist</refname> + <refpurpose>Décrit la librairie dbm utilisée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>dblist</function></funcdef> <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - </refsect1> - </refentry> - </reference> + </funcprototype> + </funcsynopsis> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/dbm.xml diff -u phpdoc/fr/functions/dbm.xml:1.5 phpdoc/fr/functions/dbm.xml:1.6 --- phpdoc/fr/functions/dbm.xml:1.5 Sat Jul 7 18:22:05 2001 +++ phpdoc/fr/functions/dbm.xml Thu Aug 2 05:53:25 2001 @@ -1,10 +1,10 @@ - <reference id="ref.dbm"> - <title>DBM</title> - <titleabbrev>DBM</titleabbrev> - <partintro> +<reference id="ref.dbm"> + <title>DBM</title> + <titleabbrev>DBM</titleabbrev> + <partintro> <simpara> Ces fonctions vous permettent d'écrire des lignes dans une - base de donnée de type dbm. Ce type de base (supporté + base de données de type dbm. Ce type de base (supporté par Berkeley db, gdbm, et quelques librairies systèmes, ou certaines librairies du système d'exploitation) enregistre les paires clés/valeurs, (contrairement aux enregistrements @@ -13,282 +13,282 @@ </simpara> <para> <example> - <title>dbm</title> + <title>Présentation de dbm</title> <programlisting role="php"> <?php -$dbm = dbmopen("dernier", "w"); -if (dbmexists($dbm, $userid)) { - $last_seen = dbmfetch($dbm, $userid); -} else { - dbminsert($dbm, $userid, time()); -} -faire_quelquechose(); -dbmreplace($dbm, $userid, time()); -dbmclose($dbm); + $dbm = dbmopen("dernier", "w"); + if (dbmexists($dbm, $userid)) { + $last_seen = dbmfetch($dbm, $userid); + } else { + dbminsert($dbm, $userid, time()); + } + faire_quelquechose(); + dbmreplace($dbm, $userid, time()); + dbmclose($dbm); ?> </programlisting> </example> </para> - </partintro> - <refentry id="function.dbmopen"> - <refnamediv> - <refname>dbmopen</refname> - <refpurpose>Ouvre une base de données dbm</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource <function>dbmopen</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>string <parameter>flags</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Le premier argument est le chemin absolu jusqu'au fichier dbm à - ouvrir. Le deuxième argument est le mode d'ouverture du fichier, - qui peut prendre les valeurs suivantes : "r", "n", "c" ou "w" qui - représentent respectivement lecture seule, nouveau (ce qui - implique lecture/écriture, et qui, probablement, va - écraser une base existante), création(ce qui - implique lecture/écriture, et qui, probablement, va - écraser une base existante), et lecture/écriture. - </para> - <para> - <function>dbmopen</function> retourne un identifiant, qui - sera passé à toutes les autres fonctions dbm, - en cas de succès, ou &false; en - cas d'échec. - </para> - <para> - Si ndbm est utilisé, ndbm va créer les fichiers - <filename>filename.dir</filename> et <filename>filename.pag</filename>. - gdbm n'utilise qu'un fichier, tout comme les librairies internes, - et Berkeley db crée - le fichier <filename>filename.db</filename>. Notez que PHP - dispose de son propre système de verrouillage des - fichiers, qui s'additionne à celui éventuellement - utilisé par les librairies. PHP n'efface jamais les fichiers - <filename>.lck</filename> qu'il crée. Il les utilise comme - inode fixe, sur lequel faire le verrouillage. - Pour plus d'informations sur les fichiers dbm, reportez vous - à vos pages de manuel Unix (man) , ou bien chargez gdbm : - <filename role="url">ftp://prep.ai.mit.edu/pub/gnu</filename>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmclose"> - <refnamediv> - <refname>dbmclose</refname> - <refpurpose>Ferme une base de données dbm.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dbmclose</function></funcdef> + </partintro> + <refentry id="function.dbmopen"> + <refnamediv> + <refname>dbmopen</refname> + <refpurpose>Ouvre une base de données dbm</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>dbmopen</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>string <parameter>flags</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Le premier argument est le chemin absolu jusqu'au fichier dbm à + ouvrir. Le deuxième argument est le mode d'ouverture du fichier, + qui peut prendre les valeurs suivantes : "r", "n", "c" ou "w" qui + représentent respectivement lecture seule, nouveau (ce qui + implique lecture/écriture, et qui, probablement, va + écraser une base existante), création(ce qui + implique lecture/écriture, et qui, probablement, va + écraser une base existante), et lecture/écriture. + </para> + <para> + <function>dbmopen</function> retourne un identifiant, qui + sera passé à toutes les autres fonctions dbm, + en cas de succès, ou <literal>FALSE</literal> en + cas d'échec. + </para> + <para> + Si ndbm est utilisé, ndbm va créer les fichiers + <filename>filename.dir</filename> et <filename>filename.pag</filename>. + gdbm n'utilise qu'un fichier, tout comme les librairies internes, + et Berkeley db crée + le fichier <filename>filename.db</filename>. Notez que PHP + dispose de son propre système de verrouillage des + fichiers, qui s'additionne à celui éventuellement + utilisé par les librairies. PHP n'efface jamais les fichiers + <filename>.lck</filename> qu'il crée. Il les utilise comme + inode fixe, sur lequel faire le verrouillage. + Pour plus d'informations sur les fichiers dbm, reportez-vous + à vos pages de manuel Unix (man) , ou bien chargez gdbm : + <filename role="url">ftp://prep.ai.mit.edu/pub/gnu</filename>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmclose"> + <refnamediv> + <refname>dbmclose</refname> + <refpurpose>Ferme une base de données dbm.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbmclose</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmclose</function> déverrouille et - ferme la base de données <parameter>dbm_identifier</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmexists"> - <refnamediv> - <refname>dbmexists</refname> - <refpurpose>Indique si une valeur existe.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dbmexists</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmclose</function> déverrouille et + ferme la base de données <parameter>dbm_identifier</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmexists"> + <refnamediv> + <refname>dbmexists</refname> + <refpurpose>Indique si une valeur existe.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbmexists</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmexists</function> retourne &true; - si il y a une valeur associée à la clé - <parameter>key</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmfetch"> - <refnamediv> - <refname>dbmfetch</refname> - <refpurpose>Lit une valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmexists</function> retourne <literal>TRUE</literal> + s'il y a une valeur associée à la clé + <parameter>key</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmfetch"> + <refnamediv> + <refname>dbmfetch</refname> + <refpurpose>Lit une valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>dbmfetch</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmfetch</function> retourne la valeur associée - à la clé <parameter>key</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbminsert"> - <refnamediv> - <refname>dbminsert</refname> - <refpurpose>Insère une valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmfetch</function> retourne la valeur associée + à la clé <parameter>key</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbminsert"> + <refnamediv> + <refname>dbminsert</refname> + <refpurpose>Insère une valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbminsert</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> <paramdef>string <parameter>value</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbminsert</function> ajoute la valeur - <parameter>value</parameter> dans la base de - données, avec la clé <parameter>key</parameter>. - </para> - <para> - <function>dbminsert</function> retourne -1 si la base a - été ouverte en mode lecture - seule, 0 si l'insertion a été réussie, et 1 si - la clé key existe déjà. (Pour remplacer la - valeur, utilisez <function>dbmreplace</function>.) - </para> - </refsect1> - </refentry> - <refentry id="function.dbmreplace"> - <refnamediv> - <refname>dbmreplace</refname> - <refpurpose>Remplace une valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dbmreplace</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbminsert</function> ajoute la valeur + <parameter>value</parameter> dans la base de + données, avec la clé <parameter>key</parameter>. + </para> + <para> + <function>dbminsert</function> retourne -1 si la base a + été ouverte en mode lecture + seule, 0 si l'insertion a été réussie, et 1 si + la clé key existe déjà. (Pour remplacer la + valeur, utilisez <function>dbmreplace</function>.) + </para> + </refsect1> + </refentry> + <refentry id="function.dbmreplace"> + <refnamediv> + <refname>dbmreplace</refname> + <refpurpose>Remplace une valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbmreplace</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> <paramdef>string <parameter>value</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmreplace</function> remplace la valeur courante par - la valeur <parameter>value</parameter> pour la clé - <parameter>key</parameter>, dans une base <parameter>dbm_identifier</parameter>. - </para> - <para> - <function>dbmreplace</function> crée la clé, si elle n'existe pas - dans la base. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmdelete"> - <refnamediv> - <refname>dbmdelete</refname> - <refpurpose>Efface une valeur.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>dbmdelete</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmreplace</function> remplace la valeur courante par + la valeur <parameter>value</parameter> pour la clé + <parameter>key</parameter>, dans une base <parameter>dbm_identifier</parameter>. + </para> + <para> + <function>dbmreplace</function> crée la clé, si elle n'existe pas + dans la base. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmdelete"> + <refnamediv> + <refname>dbmdelete</refname> + <refpurpose>Efface une valeur.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbmdelete</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmdelete</function> efface la valeur de la clé - <parameter>key</parameter>, dans la base <parameter>dbm_identifier</parameter>. - </para> - <para> - <function>dbmdelete</function> retourne &false; - si la clé n'existe pas dans cette base. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmfirstkey"> - <refnamediv> - <refname>dbmfirstkey</refname> - <refpurpose>Lit la première clé.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmdelete</function> efface la valeur de la clé + <parameter>key</parameter>, dans la base <parameter>dbm_identifier</parameter>. + </para> + <para> + <function>dbmdelete</function> retourne <literal>FALSE</literal> + si la clé n'existe pas dans cette base. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmfirstkey"> + <refnamediv> + <refname>dbmfirstkey</refname> + <refpurpose>Lit la première clé.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>dbmfirstkey</function></funcdef> <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmfirstkey</function> retourne la première - clé de la base de données. Notez bien que les - clés ne sont pas dans un ordre défini, - étant donné que la table est construite comme une table - de hash. - </para> - </refsect1> - </refentry> - <refentry id="function.dbmnextkey"> - <refnamediv> - <refname>dbmnextkey</refname> - <refpurpose>Lit la clé suivante.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dbmnextkey</function></funcdef> - <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> - <paramdef>string <parameter>key</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>dbmnextkey</function> retourne la clé après la clé - <parameter>key</parameter>. En appelant <function>dbmfirstkey</function>, - puis successivement <function>dbmnextkey</function>, il est - possible de passer en revue toute les paires clé/valeur - de la base de données dbm. Par exemple : - <example> - <title>Passer en revue une base de données.</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmfirstkey</function> retourne la première + clé de la base de données. Notez bien que les + clés ne sont pas dans un ordre défini, + étant donné que la table est construite comme un tableau + associatif. + </para> + </refsect1> + </refentry> + <refentry id="function.dbmnextkey"> + <refnamediv> + <refname>dbmnextkey</refname> + <refpurpose>Lit la clé suivante.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dbmnextkey</function></funcdef> + <paramdef>resource <parameter>dbm_identifier</parameter></paramdef> + <paramdef>string <parameter>key</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbmnextkey</function> retourne la clé après la clé + <parameter>key</parameter>. En appelant <function>dbmfirstkey</function>, + puis successivement <function>dbmnextkey</function>, il est + possible de passer en revue toute les paires clé/valeur + de la base de données dbm. Par exemple : + <example> + <title>Passer en revue une base de données.</title> + <programlisting role="php"> <?php -$key = dbmfirstkey($dbm_id); -while ($key) { - echo "$key = " . dbmfetch($dbm_id, $key) . "\n"; - $key = dbmnextkey($dbm_id, $key); -} + $cle = dbmfirstkey($dbm_id); + while ($cle){ + echo "$cle = " . dbmfetch($dbm_id, $cle) . "\n"; + $cle = dbmnextkey($dbm_id, $cle); + } ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.dblist"> - <refnamediv> - <refname>dblist</refname> - <refpurpose>Décrit la librairie dbm utilisée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.dblist"> + <refnamediv> + <refname>dblist</refname> + <refpurpose>Décrit la librairie dbm utilisée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>string <function>dblist</function></funcdef> <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - </refsect1> - </refentry> - </reference> + </funcprototype> + </funcsynopsis> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml