cvs: phpdoc /fr/functions dbase.xml
| From: | Damien Seguy | Date: | Thu, 02 Aug 2001 09:52:08 +0000 |
| Subject: | cvs: phpdoc /fr/functions dbase.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336688@lists.php.net to get a copy of this message | ||
dams Thu Aug 2 05:52:08 2001 EDT
Modified files:
/phpdoc/fr/functions dbase.xml
Log:
Typos
Index: phpdoc/fr/functions/dbase.xml diff -u phpdoc/fr/functions/dbase.xml:1.5 phpdoc/fr/functions/dbase.xml:1.6 --- phpdoc/fr/functions/dbase.xml:1.5 Sat Jul 7 18:22:05 2001 +++ phpdoc/fr/functions/dbase.xml Thu Aug 2 05:52:07 2001 @@ -1,118 +1,116 @@ - <reference id="ref.dbase"> - <title>dBase</title> - <titleabbrev>dBase</titleabbrev> - <partintro> - <simpara> - Ces fonctions vous permettront d'accéder aux enregistrements d'une base au format - dBase (.dbf). - </simpara> - <simpara> - dBase ne permet pas l'utilisation d'index, de "memo fields", ni le blocage - de la base. Deux processus de serveurs web différents modifiant - la même fichier dBase risque de rendre votre base de - données incohérente. - </simpara> - <simpara> - A la différence des bases de données SQL, la définition - des bases de données dBase, ne peut pas être changée. Une - fois le fichier créé, la définition de la base est - définitive. Il n'y a pas d'index qui accélèrent les recherches - ou organisent vos données. Les fichiers dBase sont de simples fichiers - séquentiels avec des enregistrements de longueur fixe. Les - enregistrements sont ajoutés à la fin du fichier et les - enregistrements supprimés sont conservés jusqu'à - l'appel de <function>dbase_pack</function>. - </simpara> - <simpara> - Nous vous recommandons de ne pas utiliser les fichiers dBase comme base - de données de production. Choisissez n'importe quel serveur SQL - à la place. MySQL et PostgresSQL sont des choix classiques avec - PHP. Le support de dBase ne se justifie ici que pour vous permettre - d'importer et d'exporter des données de et vers votre base des - données web, maintenant que le format du fichier est - communément géré par les feuilles et - organiseurs Windows. L'import et l'export de données est l'unique - chose pour laquelle l'utilisation de dBase est recommandée. - </simpara> - </partintro> - <refentry id="function.dbase-create"> - <refnamediv> - <refname>dbase_create</refname> - <refpurpose>Crée une base de données dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> +<reference id="ref.dbase"> + <title>dBase</title> + <titleabbrev>dBase</titleabbrev> + <partintro> + <simpara> + Ces fonctions vous permettront d'accéder aux enregistrements + d'une base au format dBase (.dbf). + </simpara> + <simpara> + dBase ne permet pas l'utilisation d'index, de "memo fields", ni le blocage + de la base. Deux processus de serveurs web différents modifiant + le même fichier dBase risque de rendre votre base de + données incohérente. + </simpara> + <simpara> + Les fichiers dBase sont de simples fichiers séquentiels + d'enregistrements de longueur fixe. Les enregistrements sont + ajoutés à la fin du fichier et les enregistrements + supprimés sont conservés jusqu'à + l'appel de <function>dbase_pack</function>. + </simpara> + <simpara> + Nous vous recommandons de ne pas utiliser les fichiers dBase comme base + de données de production. Choisissez n'importe quel serveur SQL + à la place. MySQL et PostgresSQL sont des choix classiques avec + PHP. Le support de dBase ne se justifie ici que pour vous permettre + d'importer et d'exporter des données depuis et vers votre base des + données issues du web, car ce format de fichier est + communément accepté par les feuilles et + organiseurs Windows. L'import et l'export de données est l'unique + chose pour laquelle l'utilisation de dBase est recommandée. + </simpara> + </partintro> + <refentry id="function.dbase-create"> + <refnamediv> + <refname>dbase_create</refname> + <refpurpose>Crée une base de données dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbase_create</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>array <parameter>fields</parameter></paramdef> - </funcsynopsis> - <para> - <parameter>fields</parameter> est un tableau de tableaux. Chaque tableau - décrit le format d'un fichier de la base. Chaque champs est - constitué d'un nom, d'un caractère de type de champs, - d'une longueur et d'une précision. - </para> - <para> - Les types de champs disponibles sont : - <variablelist> - <varlistentry> - <term>L</term> - <listitem> - <simpara> - Boolean (booléen). Pas de longueur ou de précision pour ces valeurs. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>M</term> - <listitem> - <simpara> - Memo. (Note importante : les Memos ne sont pas supportés par PHP.) - Elles n'ont pas de longueur ou de précision. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>D</term> - <listitem> - <simpara> - Date (enregistrée au format 'YYYYMMDD'). Elles n'ont pas de longueur ou - de précision. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>N</term> - <listitem> - <simpara> - Number (nombre). Possède une longueur et un précision (le nombre de - chiffres après la virgule). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>C</term> - <listitem> - <simpara> - String (chaîne). - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - Si la base de données a été créée, - un identifiant de base dbase_identifier est retourné, sinon, - &false; est retourné. - <example> - <title>Création d'une base dBase</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <parameter>fields</parameter> est un tableau de tableaux. Chaque tableau + décrit le format d'un fichier de la base. Chaque champs est + constitué d'un nom, d'un caractère de type de champs, + d'une longueur et d'une précision. + </para> + <para> + Les types de champs disponibles sont : + <variablelist> + <varlistentry> + <term>L</term> + <listitem> + <simpara> + Boolean (booléen). Pas de longueur ou de précision pour ces valeurs. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>M</term> + <listitem> + <simpara> + Memo. (Note importante : les Memos ne sont pas supportés par PHP.) + Elles n'ont pas de longueur ou de précision. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>D</term> + <listitem> + <simpara> + Date (enregistrée au format 'YYYYMMDD'). Elles n'ont pas de longueur ou + de précision. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>N</term> + <listitem> + <simpara> + Number (nombre). Possède une longueur et un précision (le nombre de + chiffres après la virgule). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>C</term> + <listitem> + <simpara> + String (chaîne). + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Si la base de données a été créée, + un identifiant de base dbase_identifier est retourné, sinon, + <literal>FALSE</literal> est retourné. + <example> + <title>Création d'une base dBase</title> + <programlisting role="php"> <?php // "database" name -$dbname = "/tmp/test.dbf"; + $dbname = "/tmp/test.dbf"; // database "definition" -$def = + $def = array( array("date", "D"), array("name", "C", 50), @@ -121,254 +119,275 @@ array("ismember", "L") ); // création -if (!dbase_create($dbname, $def)) + if (!dbase_create($dbname, $def)) print "<strong>Error!</strong>"; ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-open"> - <refnamediv> - <refname>dbase_open</refname> - <refpurpose>Ouverture d'une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-open"> + <refnamediv> + <refname>dbase_open</refname> + <refpurpose>Ouverture d'une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbase_open</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>int <parameter>flags</parameter></paramdef> - </funcsynopsis> - <para> - <parameter>flags</parameter> est un flag, comme pour la fonction open(). - (Typiquement; 0 signifie lecture seule, 1 signifie écriture seule, et - 2 écriture/lecture). - </para> - <para> - <function>dbase_open</function> retourne un identifiant de base de - données, ou &false; si la base n'a pas pu être - selectionnée. - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-close"> - <refnamediv> - <refname>dbase_close</refname> - <refpurpose>Ferme une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_close</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>flags</parameter> est un flag, comme pour la fonction open(). + (Typiquement; 0 signifie lecture seule, 1 signifie écriture seule, et + 2 écriture/lecture). + </para> + <para> + <function>dbase_open</function> retourne un identifiant de base de + données, ou <literal>FALSE</literal> si la base n'a pas pu être + sélectionnée. + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-close"> + <refnamediv> + <refname>dbase_close</refname> + <refpurpose>Ferme une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_close</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_close</function> ferme la base associée à - <parameter>dbase_identifier</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-pack"> - <refnamediv> - <refname>dbase_pack</refname> - <refpurpose>Compacte une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_pack</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_close</function> ferme la base associée à + <parameter>dbase_identifier</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-pack"> + <refnamediv> + <refname>dbase_pack</refname> + <refpurpose>Compacte une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_pack</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_pack</function> compacte la base de données - <parameter>dbase_identifier</parameter> (effacement définitif de tous les - enregistrements marqués pour l'effacement, avec la fonction - <function>dbase_delete_record</function>). - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-add-record"> - <refnamediv> - <refname>dbase_add_record</refname> - <refpurpose>Ajoute un enregistrement dans une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_add_record</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_pack</function> compacte la base de données + <parameter>dbase_identifier</parameter> (effacement définitif + de tous les enregistrements marqués pour l'effacement, + avec la fonction <function>dbase_delete_record</function>). + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-add-record"> + <refnamediv> + <refname>dbase_add_record</refname> + <refpurpose>Ajoute un enregistrement dans une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_add_record</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>array <parameter>record</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_add_record</function> ajoute les données de - <parameter>record</parameter> dans la base spécifiée par - <parameter>dbase_identifier</parameter>. Si le nombre de colonnes fourni - n'est pas celui du nombre de champs dans la base, l'opération - échouera, et &false; sera retourné. - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-replace-record"> - <refnamediv> - <refname>dbase_replace_record</refname> - <refpurpose>Remplace un enregistrement dans une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_replace_record</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_add_record</function> ajoute les données de + <parameter>record</parameter> dans la base spécifiée par + <parameter>dbase_identifier</parameter>. Si le nombre de colonnes fourni + n'est pas celui du nombre de champs dans la base, l'opération + échouera, et <literal>FALSE</literal> sera retourné. + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-replace-record"> + <refnamediv> + <refname>dbase_replace_record</refname> + <refpurpose>Remplace un enregistrement dans une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_replace_record</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>array <parameter>record</parameter></paramdef> <paramdef>int <parameter>dbase_record_number</parameter></paramdef> - </funcsynopsis> - <simpara> - <function>dbase_replace_record</function> remplace les données - associées à l'enregistrement <parameter>record_number</parameter> - par les données enregistrées dans <parameter>record</parameter>. - Si le nombre de colonnes fourni n'est pas celui du nombre de champs dans la base, - l'opération échouera, et &false; sera retourné. + </funcprototype> + </funcsynopsis> + <simpara> + <function>dbase_replace_record</function> remplace les données + associées à l'enregistrement <parameter>record_number</parameter> + par les données enregistrées dans <parameter>record</parameter>. + Si le nombre de colonnes fourni n'est pas celui du nombre de champs dans la base, + l'opération échouera, et <literal>FALSE</literal> sera retourné. + </simpara> + <simpara> + <parameter>dbase_record_number</parameter> est un entier qui peut aller de 1 + jusqu'au nombre maximal d'enregistrement de la base (retourné par + <function>dbase_numrecords</function>). </simpara> - <simpara> - <parameter>dbase_record_number</parameter> est un entier qui peut aller de 1 - jusqu'au nombre maximal d'enregistrement de la base (retourné par - <function>dbase_numrecords</function>). - </simpara> - </refsect1> - </refentry> - <refentry id="function.dbase-delete-record"> - <refnamediv> - <refname>dbase_delete_record</refname> - <refpurpose>Efface un enregistrement dans une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_delete_record</function></funcdef> + </refsect1> + </refentry> + <refentry id="function.dbase-delete-record"> + <refnamediv> + <refname>dbase_delete_record</refname> + <refpurpose>Efface un enregistrement dans une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_delete_record</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>int <parameter>record</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_delete_record</function> marque l'enregistrement - <parameter>record</parameter> pour l'effacement, dans la base - <parameter>dbase_identifier</parameter>. Pour effacer réellement - l'enregistrement, il faut utiliser aussi <function>dbase_pack</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-get-record"> - <refnamediv> - <refname>dbase_get_record</refname> - <refpurpose>Lit un enregistrement dans une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_delete_record</function> marque l'enregistrement + <parameter>record</parameter> pour l'effacement, dans la base + <parameter>dbase_identifier</parameter>. Pour effacer réellement + l'enregistrement, il faut utiliser aussi <function>dbase_pack</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-get-record"> + <refnamediv> + <refname>dbase_get_record</refname> + <refpurpose>Lit un enregistrement dans une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>array <function>dbase_get_record</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>int <parameter>record</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_get_record</function> retourne les données de - l'enregistrement <parameter>record</parameter> dans un tableau. Le tableau est - indexé à partir de 0, et inclus un membre nommé 'deleted' - (effacé), qui sera mis à 1 si l'enregistrement a été - marqué pour l'effacement (voir <function>dbase_delete_record</function>). - </para> - <para> - Chaque champs est converti au format approprié PHP. (Les dates sont - laissées au format chaîne). - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-get-record-with-names"> - <refnamediv> - <refname>dbase_get_record_with_names</refname> - <refpurpose> - Lit un enregistrement dans une base, sous la forme d'un tableau associatif. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_get_record</function> retourne les données de + l'enregistrement <parameter>record</parameter> dans un tableau. Le tableau est + indexé à partir de 0, et inclus un membre nommé 'deleted' + (effacé), qui sera mis à 1 si l'enregistrement a été + marqué pour l'effacement (voir <function>dbase_delete_record</function>). + </para> + <para> + Chaque champs est converti au format approprié PHP. (Les dates sont + laissées au format chaîne). + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-get-record-with-names"> + <refnamediv> + <refname>dbase_get_record_with_names</refname> + <refpurpose> + Lit un enregistrement dans une base, sous la forme d'un tableau associatif. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>array <function>dbase_get_record_with_names</function> </funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>int <parameter>record</parameter></paramdef> - </funcsynopsis> - <para> - <parameter>dbase_identifier</parameter> retourne les données - de l'enregistrement <parameter>record</parameter> - dans un tableau associatif. Le tableau inclus un membre nommé 'deleted' - (effacé), qui sera mis à 1 si l'enregistrement a - été marqué pour l'effacement (voir - <function>dbase_delete_record</function>). - </para> - <para> - Chaque champs est converti au format approprié PHP. (Les dates sont - laissées au format chaîne). - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-numfields"> - <refnamediv> - <refname>dbase_numfields</refname> - <refpurpose> - Compte le nombre de champs d'une base dBase. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <parameter>dbase_identifier</parameter> retourne les données + de l'enregistrement <parameter>record</parameter> + dans un tableau associatif. Le tableau inclus un membre nommé 'deleted' + (effacé), qui sera mis à 1 si l'enregistrement a + été marqué pour l'effacement (voir + <function>dbase_delete_record</function>). + </para> + <para> + Chaque champs est converti au format approprié PHP. (Les dates sont + laissées au format chaîne). + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-numfields"> + <refnamediv> + <refname>dbase_numfields</refname> + <refpurpose> + Compte le nombre de champs d'une base dBase. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbase_numfields</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_numfields</function> retourne le nombre de champs (colonnes) - de la base de données <parameter>dbase_identifier</parameter>. - Les numéros de champs sont numérotés de 0 à - dbase_numfields($db)-1, tandis que les numéros d'enregistrements - sont numérotés de 1 à dbase_numrecords($db). - <example> - <title>Utiliser <function>dbase_numfields</function></title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_numfields</function> retourne le nombre de champs (colonnes) + de la base de données <parameter>dbase_identifier</parameter>. + Les numéros de champs sont numérotés de 0 à + dbase_numfields($db)-1, tandis que les numéros d'enregistrements + sont numérotés de 1 à dbase_numrecords($db). + <example> + <title>Utiliser <function>dbase_numfields</function></title> + <programlisting role="php"> <?php -$rec = dbase_get_record($db, $recno); -$nf = dbase_numfields($db); -for ($i=0; $i < $nf; $i++) { - print $rec[$i]."<br>\n"; -} + $rec = dbase_get_record($db, $recno); + $nf = dbase_numfields($db); + for ($i=0; $i < $nf; $i++) { + print $rec[$i]."<br>\n"; + } ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-numrecords"> - <refnamediv> - <refname>dbase_numrecords</refname> - <refpurpose> - Compter le nombre d'enregistrements dans une base dBase. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-numrecords"> + <refnamediv> + <refname>dbase_numrecords</refname> + <refpurpose> + Compter le nombre d'enregistrements dans une base dBase. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbase_numrecords</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_numrecords</function> retourne le nombre d'enregistrements - (lignes) dans la base <parameter>dbase_identifier</parameter>. - Les numéros de champs sont numérotés de 0 à - dbase_numfields($db)-1, tandis que les numéros d'enregistrements - sont numérotés de 1 à dbase_numrecords($db). - </para> - </refsect1> - </refentry> - </reference> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_numrecords</function> retourne le nombre d'enregistrements + (lignes) dans la base <parameter>dbase_identifier</parameter>. + Les numéros de champs sont numérotés de 0 à + <literal>dbase_numfields($db)-1</literal>, tandis que les numéros + d'enregistrements sont numérotés de 1 à + <literal>dbase_numrecords($db)</literal>. + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/dbase.xml diff -u phpdoc/fr/functions/dbase.xml:1.5 phpdoc/fr/functions/dbase.xml:1.6 --- phpdoc/fr/functions/dbase.xml:1.5 Sat Jul 7 18:22:05 2001 +++ phpdoc/fr/functions/dbase.xml Thu Aug 2 05:52:07 2001 @@ -1,118 +1,116 @@ - <reference id="ref.dbase"> - <title>dBase</title> - <titleabbrev>dBase</titleabbrev> - <partintro> - <simpara> - Ces fonctions vous permettront d'accéder aux enregistrements d'une base au format - dBase (.dbf). - </simpara> - <simpara> - dBase ne permet pas l'utilisation d'index, de "memo fields", ni le blocage - de la base. Deux processus de serveurs web différents modifiant - la même fichier dBase risque de rendre votre base de - données incohérente. - </simpara> - <simpara> - A la différence des bases de données SQL, la définition - des bases de données dBase, ne peut pas être changée. Une - fois le fichier créé, la définition de la base est - définitive. Il n'y a pas d'index qui accélèrent les recherches - ou organisent vos données. Les fichiers dBase sont de simples fichiers - séquentiels avec des enregistrements de longueur fixe. Les - enregistrements sont ajoutés à la fin du fichier et les - enregistrements supprimés sont conservés jusqu'à - l'appel de <function>dbase_pack</function>. - </simpara> - <simpara> - Nous vous recommandons de ne pas utiliser les fichiers dBase comme base - de données de production. Choisissez n'importe quel serveur SQL - à la place. MySQL et PostgresSQL sont des choix classiques avec - PHP. Le support de dBase ne se justifie ici que pour vous permettre - d'importer et d'exporter des données de et vers votre base des - données web, maintenant que le format du fichier est - communément géré par les feuilles et - organiseurs Windows. L'import et l'export de données est l'unique - chose pour laquelle l'utilisation de dBase est recommandée. - </simpara> - </partintro> - <refentry id="function.dbase-create"> - <refnamediv> - <refname>dbase_create</refname> - <refpurpose>Crée une base de données dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> +<reference id="ref.dbase"> + <title>dBase</title> + <titleabbrev>dBase</titleabbrev> + <partintro> + <simpara> + Ces fonctions vous permettront d'accéder aux enregistrements + d'une base au format dBase (.dbf). + </simpara> + <simpara> + dBase ne permet pas l'utilisation d'index, de "memo fields", ni le blocage + de la base. Deux processus de serveurs web différents modifiant + le même fichier dBase risque de rendre votre base de + données incohérente. + </simpara> + <simpara> + Les fichiers dBase sont de simples fichiers séquentiels + d'enregistrements de longueur fixe. Les enregistrements sont + ajoutés à la fin du fichier et les enregistrements + supprimés sont conservés jusqu'à + l'appel de <function>dbase_pack</function>. + </simpara> + <simpara> + Nous vous recommandons de ne pas utiliser les fichiers dBase comme base + de données de production. Choisissez n'importe quel serveur SQL + à la place. MySQL et PostgresSQL sont des choix classiques avec + PHP. Le support de dBase ne se justifie ici que pour vous permettre + d'importer et d'exporter des données depuis et vers votre base des + données issues du web, car ce format de fichier est + communément accepté par les feuilles et + organiseurs Windows. L'import et l'export de données est l'unique + chose pour laquelle l'utilisation de dBase est recommandée. + </simpara> + </partintro> + <refentry id="function.dbase-create"> + <refnamediv> + <refname>dbase_create</refname> + <refpurpose>Crée une base de données dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbase_create</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>array <parameter>fields</parameter></paramdef> - </funcsynopsis> - <para> - <parameter>fields</parameter> est un tableau de tableaux. Chaque tableau - décrit le format d'un fichier de la base. Chaque champs est - constitué d'un nom, d'un caractère de type de champs, - d'une longueur et d'une précision. - </para> - <para> - Les types de champs disponibles sont : - <variablelist> - <varlistentry> - <term>L</term> - <listitem> - <simpara> - Boolean (booléen). Pas de longueur ou de précision pour ces valeurs. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>M</term> - <listitem> - <simpara> - Memo. (Note importante : les Memos ne sont pas supportés par PHP.) - Elles n'ont pas de longueur ou de précision. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>D</term> - <listitem> - <simpara> - Date (enregistrée au format 'YYYYMMDD'). Elles n'ont pas de longueur ou - de précision. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>N</term> - <listitem> - <simpara> - Number (nombre). Possède une longueur et un précision (le nombre de - chiffres après la virgule). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>C</term> - <listitem> - <simpara> - String (chaîne). - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - Si la base de données a été créée, - un identifiant de base dbase_identifier est retourné, sinon, - &false; est retourné. - <example> - <title>Création d'une base dBase</title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <parameter>fields</parameter> est un tableau de tableaux. Chaque tableau + décrit le format d'un fichier de la base. Chaque champs est + constitué d'un nom, d'un caractère de type de champs, + d'une longueur et d'une précision. + </para> + <para> + Les types de champs disponibles sont : + <variablelist> + <varlistentry> + <term>L</term> + <listitem> + <simpara> + Boolean (booléen). Pas de longueur ou de précision pour ces valeurs. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>M</term> + <listitem> + <simpara> + Memo. (Note importante : les Memos ne sont pas supportés par PHP.) + Elles n'ont pas de longueur ou de précision. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>D</term> + <listitem> + <simpara> + Date (enregistrée au format 'YYYYMMDD'). Elles n'ont pas de longueur ou + de précision. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>N</term> + <listitem> + <simpara> + Number (nombre). Possède une longueur et un précision (le nombre de + chiffres après la virgule). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>C</term> + <listitem> + <simpara> + String (chaîne). + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Si la base de données a été créée, + un identifiant de base dbase_identifier est retourné, sinon, + <literal>FALSE</literal> est retourné. + <example> + <title>Création d'une base dBase</title> + <programlisting role="php"> <?php // "database" name -$dbname = "/tmp/test.dbf"; + $dbname = "/tmp/test.dbf"; // database "definition" -$def = + $def = array( array("date", "D"), array("name", "C", 50), @@ -121,254 +119,275 @@ array("ismember", "L") ); // création -if (!dbase_create($dbname, $def)) + if (!dbase_create($dbname, $def)) print "<strong>Error!</strong>"; ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-open"> - <refnamediv> - <refname>dbase_open</refname> - <refpurpose>Ouverture d'une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-open"> + <refnamediv> + <refname>dbase_open</refname> + <refpurpose>Ouverture d'une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbase_open</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>int <parameter>flags</parameter></paramdef> - </funcsynopsis> - <para> - <parameter>flags</parameter> est un flag, comme pour la fonction open(). - (Typiquement; 0 signifie lecture seule, 1 signifie écriture seule, et - 2 écriture/lecture). - </para> - <para> - <function>dbase_open</function> retourne un identifiant de base de - données, ou &false; si la base n'a pas pu être - selectionnée. - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-close"> - <refnamediv> - <refname>dbase_close</refname> - <refpurpose>Ferme une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_close</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>flags</parameter> est un flag, comme pour la fonction open(). + (Typiquement; 0 signifie lecture seule, 1 signifie écriture seule, et + 2 écriture/lecture). + </para> + <para> + <function>dbase_open</function> retourne un identifiant de base de + données, ou <literal>FALSE</literal> si la base n'a pas pu être + sélectionnée. + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-close"> + <refnamediv> + <refname>dbase_close</refname> + <refpurpose>Ferme une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_close</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_close</function> ferme la base associée à - <parameter>dbase_identifier</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-pack"> - <refnamediv> - <refname>dbase_pack</refname> - <refpurpose>Compacte une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_pack</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_close</function> ferme la base associée à + <parameter>dbase_identifier</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-pack"> + <refnamediv> + <refname>dbase_pack</refname> + <refpurpose>Compacte une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_pack</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_pack</function> compacte la base de données - <parameter>dbase_identifier</parameter> (effacement définitif de tous les - enregistrements marqués pour l'effacement, avec la fonction - <function>dbase_delete_record</function>). - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-add-record"> - <refnamediv> - <refname>dbase_add_record</refname> - <refpurpose>Ajoute un enregistrement dans une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_add_record</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_pack</function> compacte la base de données + <parameter>dbase_identifier</parameter> (effacement définitif + de tous les enregistrements marqués pour l'effacement, + avec la fonction <function>dbase_delete_record</function>). + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-add-record"> + <refnamediv> + <refname>dbase_add_record</refname> + <refpurpose>Ajoute un enregistrement dans une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_add_record</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>array <parameter>record</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_add_record</function> ajoute les données de - <parameter>record</parameter> dans la base spécifiée par - <parameter>dbase_identifier</parameter>. Si le nombre de colonnes fourni - n'est pas celui du nombre de champs dans la base, l'opération - échouera, et &false; sera retourné. - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-replace-record"> - <refnamediv> - <refname>dbase_replace_record</refname> - <refpurpose>Remplace un enregistrement dans une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_replace_record</function></funcdef> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_add_record</function> ajoute les données de + <parameter>record</parameter> dans la base spécifiée par + <parameter>dbase_identifier</parameter>. Si le nombre de colonnes fourni + n'est pas celui du nombre de champs dans la base, l'opération + échouera, et <literal>FALSE</literal> sera retourné. + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-replace-record"> + <refnamediv> + <refname>dbase_replace_record</refname> + <refpurpose>Remplace un enregistrement dans une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_replace_record</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>array <parameter>record</parameter></paramdef> <paramdef>int <parameter>dbase_record_number</parameter></paramdef> - </funcsynopsis> - <simpara> - <function>dbase_replace_record</function> remplace les données - associées à l'enregistrement <parameter>record_number</parameter> - par les données enregistrées dans <parameter>record</parameter>. - Si le nombre de colonnes fourni n'est pas celui du nombre de champs dans la base, - l'opération échouera, et &false; sera retourné. + </funcprototype> + </funcsynopsis> + <simpara> + <function>dbase_replace_record</function> remplace les données + associées à l'enregistrement <parameter>record_number</parameter> + par les données enregistrées dans <parameter>record</parameter>. + Si le nombre de colonnes fourni n'est pas celui du nombre de champs dans la base, + l'opération échouera, et <literal>FALSE</literal> sera retourné. + </simpara> + <simpara> + <parameter>dbase_record_number</parameter> est un entier qui peut aller de 1 + jusqu'au nombre maximal d'enregistrement de la base (retourné par + <function>dbase_numrecords</function>). </simpara> - <simpara> - <parameter>dbase_record_number</parameter> est un entier qui peut aller de 1 - jusqu'au nombre maximal d'enregistrement de la base (retourné par - <function>dbase_numrecords</function>). - </simpara> - </refsect1> - </refentry> - <refentry id="function.dbase-delete-record"> - <refnamediv> - <refname>dbase_delete_record</refname> - <refpurpose>Efface un enregistrement dans une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcdef>bool <function>dbase_delete_record</function></funcdef> + </refsect1> + </refentry> + <refentry id="function.dbase-delete-record"> + <refnamediv> + <refname>dbase_delete_record</refname> + <refpurpose>Efface un enregistrement dans une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>dbase_delete_record</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>int <parameter>record</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_delete_record</function> marque l'enregistrement - <parameter>record</parameter> pour l'effacement, dans la base - <parameter>dbase_identifier</parameter>. Pour effacer réellement - l'enregistrement, il faut utiliser aussi <function>dbase_pack</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-get-record"> - <refnamediv> - <refname>dbase_get_record</refname> - <refpurpose>Lit un enregistrement dans une base dBase.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_delete_record</function> marque l'enregistrement + <parameter>record</parameter> pour l'effacement, dans la base + <parameter>dbase_identifier</parameter>. Pour effacer réellement + l'enregistrement, il faut utiliser aussi <function>dbase_pack</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-get-record"> + <refnamediv> + <refname>dbase_get_record</refname> + <refpurpose>Lit un enregistrement dans une base dBase.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>array <function>dbase_get_record</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>int <parameter>record</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_get_record</function> retourne les données de - l'enregistrement <parameter>record</parameter> dans un tableau. Le tableau est - indexé à partir de 0, et inclus un membre nommé 'deleted' - (effacé), qui sera mis à 1 si l'enregistrement a été - marqué pour l'effacement (voir <function>dbase_delete_record</function>). - </para> - <para> - Chaque champs est converti au format approprié PHP. (Les dates sont - laissées au format chaîne). - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-get-record-with-names"> - <refnamediv> - <refname>dbase_get_record_with_names</refname> - <refpurpose> - Lit un enregistrement dans une base, sous la forme d'un tableau associatif. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_get_record</function> retourne les données de + l'enregistrement <parameter>record</parameter> dans un tableau. Le tableau est + indexé à partir de 0, et inclus un membre nommé 'deleted' + (effacé), qui sera mis à 1 si l'enregistrement a été + marqué pour l'effacement (voir <function>dbase_delete_record</function>). + </para> + <para> + Chaque champs est converti au format approprié PHP. (Les dates sont + laissées au format chaîne). + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-get-record-with-names"> + <refnamediv> + <refname>dbase_get_record_with_names</refname> + <refpurpose> + Lit un enregistrement dans une base, sous la forme d'un tableau associatif. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>array <function>dbase_get_record_with_names</function> </funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> <paramdef>int <parameter>record</parameter></paramdef> - </funcsynopsis> - <para> - <parameter>dbase_identifier</parameter> retourne les données - de l'enregistrement <parameter>record</parameter> - dans un tableau associatif. Le tableau inclus un membre nommé 'deleted' - (effacé), qui sera mis à 1 si l'enregistrement a - été marqué pour l'effacement (voir - <function>dbase_delete_record</function>). - </para> - <para> - Chaque champs est converti au format approprié PHP. (Les dates sont - laissées au format chaîne). - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-numfields"> - <refnamediv> - <refname>dbase_numfields</refname> - <refpurpose> - Compte le nombre de champs d'une base dBase. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </funcprototype> + </funcsynopsis> + <para> + <parameter>dbase_identifier</parameter> retourne les données + de l'enregistrement <parameter>record</parameter> + dans un tableau associatif. Le tableau inclus un membre nommé 'deleted' + (effacé), qui sera mis à 1 si l'enregistrement a + été marqué pour l'effacement (voir + <function>dbase_delete_record</function>). + </para> + <para> + Chaque champs est converti au format approprié PHP. (Les dates sont + laissées au format chaîne). + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-numfields"> + <refnamediv> + <refname>dbase_numfields</refname> + <refpurpose> + Compte le nombre de champs d'une base dBase. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbase_numfields</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_numfields</function> retourne le nombre de champs (colonnes) - de la base de données <parameter>dbase_identifier</parameter>. - Les numéros de champs sont numérotés de 0 à - dbase_numfields($db)-1, tandis que les numéros d'enregistrements - sont numérotés de 1 à dbase_numrecords($db). - <example> - <title>Utiliser <function>dbase_numfields</function></title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_numfields</function> retourne le nombre de champs (colonnes) + de la base de données <parameter>dbase_identifier</parameter>. + Les numéros de champs sont numérotés de 0 à + dbase_numfields($db)-1, tandis que les numéros d'enregistrements + sont numérotés de 1 à dbase_numrecords($db). + <example> + <title>Utiliser <function>dbase_numfields</function></title> + <programlisting role="php"> <?php -$rec = dbase_get_record($db, $recno); -$nf = dbase_numfields($db); -for ($i=0; $i < $nf; $i++) { - print $rec[$i]."<br>\n"; -} + $rec = dbase_get_record($db, $recno); + $nf = dbase_numfields($db); + for ($i=0; $i < $nf; $i++) { + print $rec[$i]."<br>\n"; + } ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.dbase-numrecords"> - <refnamediv> - <refname>dbase_numrecords</refname> - <refpurpose> - Compter le nombre d'enregistrements dans une base dBase. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.dbase-numrecords"> + <refnamediv> + <refname>dbase_numrecords</refname> + <refpurpose> + Compter le nombre d'enregistrements dans une base dBase. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>dbase_numrecords</function></funcdef> <paramdef>resource <parameter>dbase_identifier</parameter></paramdef> - </funcsynopsis> - <para> - <function>dbase_numrecords</function> retourne le nombre d'enregistrements - (lignes) dans la base <parameter>dbase_identifier</parameter>. - Les numéros de champs sont numérotés de 0 à - dbase_numfields($db)-1, tandis que les numéros d'enregistrements - sont numérotés de 1 à dbase_numrecords($db). - </para> - </refsect1> - </refentry> - </reference> + </funcprototype> + </funcsynopsis> + <para> + <function>dbase_numrecords</function> retourne le nombre d'enregistrements + (lignes) dans la base <parameter>dbase_identifier</parameter>. + Les numéros de champs sont numérotés de 0 à + <literal>dbase_numfields($db)-1</literal>, tandis que les numéros + d'enregistrements sont numérotés de 1 à + <literal>dbase_numrecords($db)</literal>. + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml