cvs: phpdoc-fr /reference/fbsql/functions fbsql-fetch-object.xml fbsql-fetch-row.xml fbsql-field-flags.xml fbsql-field-len.xml fbsql-field-name.xml
fbsql-field-seek.xml fbsql-field-table.xml fbsql-field-type.xml fbsql-free-result.xml fbsql-get-autostart-info.xml fbsql-hostname.xml
fbsql-insert-id.xml fbsql-list-dbs.xml fbsql-list-fields.xml fbsql-list-tables.xml fbsql-next-result.xml fbsql-num-fields.xml fbsql-num-rows.xml
fbsql-password.xml fbsql-pconnect.xml fbsql-query.xml fbsql-read-blob.xml fbsql-read-clob.xml fbsql-result.xml fbsql-rollback.xml fbsql-select-db.xml
fbsql-set-lob-mode.xml fbsql-set-password.xml fbsql-set-transaction.xml fbsql-start-db.xml fbsql-stop-db.xml fbsql-tablename.xml fbsql-username.xml
fbsql-warnings.xml
| From: | Yannick Torres | Date: | Tue, 23 Jan 2007 19:04:36 +0000 |
| Subject: | cvs: phpdoc-fr /reference/fbsql/functions fbsql-fetch-object.xml fbsql-fetch-row.xml fbsql-field-flags.xml fbsql-field-len.xml fbsql-field-name.xml fbsql-field-seek.xml fbsql-field-table.xml fbsql-field-type.xml fbsql-free-result.xml fbsql-get-autostart-info.xml fbsql-hostname.xml fbsql-insert-id.xml fbsql-list-dbs.xml fbsql-list-fields.xml fbsql-list-tables.xml fbsql-next-result.xml fbsql-num-fields.xml fbsql-num-rows.xml fbsql-password.xml fbsql-pconnect.xml fbsql-query.xml fbsql-read-blob.xml fbsql-read-clob.xml fbsql-result.xml fbsql-rollback.xml fbsql-select-db.xml fbsql-set-lob-mode.xml fbsql-set-password.xml fbsql-set-transaction.xml fbsql-start-db.xml fbsql-stop-db.xml fbsql-tablename.xml fbsql-username.xml fbsql-warnings.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-5185@lists.php.net to get a copy of this message | ||
yannick Tue Jan 23 19:04:36 2007 UTC
Modified files:
/phpdoc-fr/reference/fbsql/functions fbsql-fetch-object.xml
fbsql-fetch-row.xml
fbsql-field-flags.xml
fbsql-field-len.xml
fbsql-field-name.xml
fbsql-field-seek.xml
fbsql-field-table.xml
fbsql-field-type.xml
fbsql-free-result.xml
fbsql-get-autostart-info.xml
fbsql-hostname.xml
fbsql-insert-id.xml
fbsql-list-dbs.xml
fbsql-list-fields.xml
fbsql-list-tables.xml
fbsql-next-result.xml
fbsql-num-fields.xml
fbsql-num-rows.xml
fbsql-password.xml
fbsql-pconnect.xml
fbsql-query.xml
fbsql-read-blob.xml
fbsql-read-clob.xml
fbsql-result.xml
fbsql-rollback.xml
fbsql-select-db.xml
fbsql-set-lob-mode.xml
fbsql-set-password.xml
fbsql-set-transaction.xml
fbsql-start-db.xml
fbsql-stop-db.xml
fbsql-tablename.xml
fbsql-username.xml
fbsql-warnings.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml Tue Jan 23 19:04:36 2007 @@ -1,62 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-fetch-object"> - <refnamediv> - <refname>fbsql_fetch_object</refname> - <refpurpose>Lit une ligne de résultat sous forme d'objet</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>object</type><methodname>fbsql_fetch_object</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_fetch_object</function> retourne un objet dont - les propriétés représentent les colonnes de la ligne à lire, dans - le résultat <parameter>result</parameter>, ou &false; - s'il n'y a pas de ligne à lire. - </para> - <para> - <function>fbsql_fetch_object</function> est similaire à - <function>fbsql_fetch_array</function>, à la différence qu'elle - retourne un objet. Nous ne pouvez alors accéder aux données qu'avec - les noms des colonnes, et sous la forme de membres d'objet, et non - plus avec leurs index (les nombres ne peuvent représenter un membre - d'objet). - </para> - <para> - En terme de vitesse, cette fonction est identique à - <function>fbsql_fetch_array</function> et presque aussi rapide que - <function>fbsql_fetch_row</function> (la différence n'est pas - significative). - <example> - <title>Exemple avec <function>fbsql_fetch_object</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-fetch-object"> + <refnamediv> + <refname>fbsql_fetch_object</refname> + <refpurpose>Lit une ligne de résultat sous forme d'objet</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>object</type><methodname>fbsql_fetch_object</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_fetch_object</function> est similaire à + <function>fbsql_fetch_array</function>, à la différence qu'elle + retourne un objet. Nous ne pouvez alors accéder aux données qu'avec + les noms des colonnes, et sous la forme de membres d'objet, et non + plus avec leurs index (les nombres ne peuvent représenter un membre + d'objet). + </para> + <para> + En terme de vitesse, cette fonction est identique à + <function>fbsql_fetch_array</function> et presque aussi rapide que + <function>fbsql_fetch_row</function> (la différence n'est pas + significative). + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un objet dont les propriétés correspondent à la ligne récupérée ou + &false; s'il n'y a plus de ligne à lire. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_fetch_object</function></title> + <programlisting role="php"> <![CDATA[ <?php fbsql_connect($host, $user, $password); -$result = fbsql_db_query("database", "select * from table;"); +$result = fbsql_db_query("database", "select * from table"); while ($row = fbsql_fetch_object($result)) { - echo $row->user_id; - echo $row->fullname; + echo $row->user_id; + echo $row->fullname; } - fbsql_free_result($result); +fbsql_free_result($result); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>fbsql_fetch_array</function> et - <function>fbsql_fetch_row</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_fetch_array</function></member> + <member><function>fbsql_fetch_row</function></member> + <member><function>fbsql_fetch_assoc</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -77,4 +102,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml Tue Jan 23 19:04:36 2007 @@ -1,44 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-fetch-row"> - <refnamediv> - <refname>fbsql_fetch_row</refname> - <refpurpose>Lit une ligne de résultat sous forme de tableau numérique</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>fbsql_fetch_row</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_fetch_row</function> retourne un tableau représentant la ligne - courante dans le résultat <parameter>result</parameter>, ou - &false; s'il n'y a plus de ligne à lire. - </para> - <para> - <function>fbsql_fetch_row</function> lit une ligne de données dans le - résultat <parameter>result</parameter> et crée un tableau - indexé. Chaque colonne est stockée dans une case du tableau, dans le - même ordre que dans le résultat. Les indices commencent à 0. - </para> - <para> - Le prochain appel à <function>fbsql_fetch_row</function> va lire - la prochaine ligne, ou bien retourner &false; s'il n'y a plus - de ligne à lire. - </para> - <para> - Voir aussi - <function>fbsql_fetch_array</function>, - <function>fbsql_fetch_object</function>, - <function>fbsql_data_seek</function>, - <function>fbsql_fetch_lengths</function> et - <function>fbsql_result</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-fetch-row"> + <refnamediv> + <refname>fbsql_fetch_row</refname> + <refpurpose>Lit une ligne de résultat sous forme de tableau numérique</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>fbsql_fetch_row</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_fetch_row</function> lit une ligne de données dans le + résultat <parameter>result</parameter> et crée un tableau + indexé. + </para> + <para> + Le prochain appel à <function>fbsql_fetch_row</function> va lire + la prochaine ligne, ou bien retourner &false; s'il n'y a plus + de ligne à lire. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau qui correspond à la ligne récupérée où chaque colonne du + résultat y est stocké, en commançant par la position 0 ou &false; s'il n'y a plus + de ligne à lire. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_fetch_array</function></member> + <member><function>fbsql_fetch_assoc</function></member> + <member><function>fbsql_fetch_object</function></member> + <member><function>fbsql_data_seek</function></member> + <member><function>fbsql_fetch_lengths</function></member> + <member><function>fbsql_result</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -59,4 +80,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml Tue Jan 23 19:04:36 2007 @@ -1,31 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-flags"> - <refnamediv> - <refname>fbsql_field_flags</refname> - <refpurpose> - Lit les options associées à une colonne de résultat - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_field_flags</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_flags</function> retourne les options du - champ <parameter>field_offset</parameter>, dans le résultat - <parameter>result</parameter>. Les options sont retournées - sous la forme d'un seul mot par option, séparées par des espaces, - de façon à faciliter la manipulation avec - <function>explode</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-field-flags"> + <refnamediv> + <refname>fbsql_field_flags</refname> + <refpurpose>Lit les options associées à une colonne de résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_field_flags</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + Lit les options associées à la colonne de résultat spécifié dans le résultat. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result</parameter></term> + <listitem> + <para> + Un pointeur de résultat, retourné par la fonction + <function>fbsql_list_fields</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne les options du champ <parameter>field_offset</parameter>, + dans le résultat <parameter>result</parameter>. Les options sont + retournées sous la forme d'un seul mot par option, séparées par des + espaces, de façon à faciliter la manipulation avec <function>explode</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml Tue Jan 23 19:04:36 2007 @@ -1,28 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-len"> - <refnamediv> - <refname>fbsql_field_len</refname> - <refpurpose> - Retourne la taille d'un champ - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_field_len</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_len</function> retourne la taille - du champ <parameter>field_offset</parameter> dans le résultat - <parameter>result</parameter>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-field-len"> + <refnamediv> + <refname>fbsql_field_len</refname> + <refpurpose>Retourne la taille d'un champs</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_field_len</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + Retourne la taille du champs spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result</parameter></term> + <listitem> + <para> + Un pointeur de résultat, retourné par la fonction + <function>fbsql_list_fields</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la taille du champs spécifié. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -43,4 +73,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml:1.13 phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml:1.14 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml:1.13 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml Tue Jan 23 19:04:36 2007 @@ -1,46 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: read --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: read --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-name"> - <refnamediv> - <refname>fbsql_field_name</refname> - <refpurpose>Lit le nom d'un champ</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_field_name</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_index</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_name</function> retourne le nom du champ - numéro <parameter>field_index</parameter> dans le résultat - <parameter>result</parameter>. <parameter>field_index</parameter> - est le résultat de <function>fbsql_query</function> et - <parameter>field_index</parameter> est l'index numérique du - champ. - </para> - <note> - <para> - <parameter>field_index</parameter> commence à 0. - </para> - <para> - e.g. L'index du troisème champ est 2, et l'index du quatrième - champ est 3... - </para> - </note> + +<refentry id="function.fbsql-field-name"> + <refnamediv> + <refname>fbsql_field_name</refname> + <refpurpose>Lit le nom d'un champs</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_field_name</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_index</parameter></methodparam> + </methodsynopsis> + <para> + Lit le nom d'un champs à un index spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result</parameter></term> + <listitem> + <para> + Un pointeur de résultat, retourné par la fonction + <function>fbsql_list_fields</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>field_index</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom sous la forme d'une &string; ou &false; si le + champs n'existe pas. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_field_name</function></title> <programlisting role="php"> <![CDATA[ <?php -// La table utilisateur est constituée de trois colonnes +// La table utilisateur est constituée de trois colonnes : // user_id // username // password -$res = fbsql_db_query("users", "select * from users;", $link); + +$res = fbsql_db_query("users", "select * from users", $link); + echo fbsql_field_name($res, 0) . "\n"; echo fbsql_field_name($res, 2); ?> @@ -52,9 +80,20 @@ user_id password ]]> - </screen> - </example> + </screen> + </example> + </para> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_field_type</function></member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file @@ -76,4 +115,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml Tue Jan 23 19:04:36 2007 @@ -1,33 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-seek"> - <refnamediv> - <refname>fbsql_field_seek</refname> - <refpurpose> - Déplace le pointeur de résultat - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_field_seek</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_seek</function> place le pointeur de colonne - à la colonne <parameter>field_offset</parameter>. Si ce paramètre - est omis, <function>fbsql_fetch_field</function> retourne le - numéro de la colonne courante. - </para> - <para> - Voir aussi - <function>fbsql_fetch_field</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-field-seek"> + <refnamediv> + <refname>fbsql_field_seek</refname> + <refpurpose>Déplace le pointeur de résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_field_seek</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + Place le pointeur de colonne à la colonne spécifiée. + Si le prochain appel à <function>fbsql_fetch_field</function> + n'inclue pas un pointeur de champs, le pointeur du champs + spécifié dans <function>fbsql_field_seek</function> sera retourné. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_fetch_field</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -48,4 +77,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml Tue Jan 23 19:04:36 2007 @@ -1,28 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-table"> - <refnamediv> - <refname>fbsql_field_table</refname> - <refpurpose> - Lit le nom de la table d'origine d'un champ - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_field_table</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_table</function> retourne le nom de la - table d'où est issu le champ d'indice <parameter>field_offset</parameter>. - Les numéros de colonnes commencent à 0. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-field-table"> + <refnamediv> + <refname>fbsql_field_table</refname> + <refpurpose>Lit le nom de la table d'origine d'un champs</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_field_table</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le nom de la table d'où est issu le champs spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de la table, sous la forme d'une &string;. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -43,4 +65,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml Tue Jan 23 19:04:36 2007 @@ -1,58 +1,102 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-type"> - <refnamediv> - <refname>fbsql_field_type</refname> - <refpurpose> - Lit le type d'une colonne - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_field_type</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_type</function> est similaire à la fonction - <function>fbsql_field_name</function>. Les arguments sont - identiques, mais le type du champ est retourné. Il peut - valoir "int", "real", "string", "blob" ou d'autres valeurs, - comme décrit dans <ulink url="&url.fbsql.docs;">la documentation - FrontBase</ulink>. - <example> - <title>Exemple avec <function>fbsql_field_type</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-field-type"> + <refnamediv> + <refname>fbsql_field_type</refname> + <refpurpose>Lit le type d'une colonne</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_field_type</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_field_type</function> est similaire à la fonction + <function>fbsql_field_name</function>. Les arguments sont + identiques, mais le type du champ est retourné. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le type du champs, sous la forme d'une &string;. + </para> + <para> + Ce type peut être un parmis <literal>int</literal>, <literal>real</literal>, + <literal>string</literal>, <literal>blob</literal>, et d'autres, tel que spécifié + dans la <ulink url="&url.fbsql.docs;">documentation de FrontBase</ulink>. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_field_type</function></title> + <programlisting role="php"> <![CDATA[ <?php -fbsql_connect("localhost:3306"); + fbsql_connect("localhost", "_SYSTEM", ""); +fbsql_select_db("wisconsin"); $result = fbsql_query("SELECT * FROM onek;"); $fields = fbsql_num_fields($result); $rows = fbsql_num_rows($result); $i = 0; $table = fbsql_field_table($result, $i); echo "Votre table '" . $table . "' a " . $fields . " colonnes et " . $rows . " lignes <br />"; -echo 'La table dispose des champs suivants <br />'; +echo "TLa table dispose des champs suivants <br />"; while ($i < $fields) { - $type = fbsql_field_type ($result, $i); - $name = fbsql_field_name ($result, $i); - $len = fbsql_field_len ($result, $i); - $flags = fbsql_field_flags($result, $i); - echo $type . ' ' . $name . ' ' . $len . ' ' . $flags . '<br />'; - $i++; + $type = fbsql_field_type($result, $i); + $name = fbsql_field_name($result, $i); + $len = fbsql_field_len($result, $i); + $flags = fbsql_field_flags($result, $i); + echo $type . " " . $name . " " . $len . " " . $flags . "<br />"; + $i++; } fbsql_close(); + ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_field_name</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -73,4 +117,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml Tue Jan 23 19:04:36 2007 @@ -1,31 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-free-result"> - <refnamediv> - <refname>fbsql_free_result</refname> - <refpurpose>Libère le résultat de la mémoire</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_free_result</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_free_result</function> va libérer toute la mémoire - utilisée par le résultat associé à la ressource <parameter>result</parameter>. - </para> - <para> - <function>fbsql_free_result</function> n'a besoin d'être appelé que si vous - craignez que votre script ne consomme trop de mémoire, lorsqu'une - requête retourne de très grands résultats. Toutes les ressources - mémoire utilisées par le script sont de toute manière libérées à - la fin du script. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-free-result"> + <refnamediv> + <refname>fbsql_free_result</refname> + <refpurpose>Libère le résultat de la mémoire</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_free_result</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + Libérer toute la mémoire utilisée par le résultat associé à la ressource <parameter>result</parameter>. + </para> + <para> + <function>fbsql_free_result</function> n'a besoin d'être appelé que si vous + craignez que votre script ne consomme trop de mémoire, lorsqu'une + requête retourne de très grands résultats. Toutes les ressources + mémoire utilisées par le script sont de toute manière libérées à + la fin du script. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +63,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml:1.5 phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml:1.6 --- phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml:1.5 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml Tue Jan 23 19:04:36 2007 @@ -1,23 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-get-autostart-info"> - <refnamediv> - <refname>fbsql_get_autostart_info</refname> - <refpurpose>Pas de documentation</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>fbsql_get_autostart_info</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-get-autostart-info'> + <refnamediv> + <refname>fbsql_get_autostart_info</refname> + <refpurpose></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>fbsql_get_autostart_info</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -38,4 +48,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml:1.6 phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml:1.7 --- phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml:1.6 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml Tue Jan 23 19:04:36 2007 @@ -1,24 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id='function.fbsql-hostname'> - <refnamediv> - <refname>fbsql_hostname</refname> - <refpurpose>Lit ou définit le nom de l'hôte à utiliser avec une connexion</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_hostname</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>host_name</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-hostname'> + <refnamediv> + <refname>fbsql_hostname</refname> + <refpurpose>Lit ou définit le nom de l'hôte à utiliser avec une connexion</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_hostname</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>host_name</parameter></methodparam> + </methodsynopsis> + <para> + Lit ou définit le nom de l'hôte à utiliser avec une connexion. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>host_name</parameter></term> + <listitem> + <para> + Si fourni, ce sera le nouveau nom de l'hôte à utiliser. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de l'hôte courant pour la connexion. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_username</function></member> + <member><function>fbsql_password</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -39,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml Tue Jan 23 19:04:36 2007 @@ -1,45 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-insert-id"> - <refnamediv> - <refname>fbsql_insert_id</refname> - <refpurpose> - Lit le dernier identifiant généré par une requête INSERT - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_insert_id</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_insert_id</function> retourne l'identifiant généré - par la colonne de type DEFAULT UNIQUE, lors de la dernière requête - INSERT, avec la connexion <parameter>link_identifier</parameter>. - Si <parameter>link_identifier</parameter> est omis, la dernière connexion - ouverte est utilisée. - </para> + +<refentry id="function.fbsql-insert-id"> + <refnamediv> + <refname>fbsql_insert_id</refname> + <refpurpose>Lit le dernier identifiant généré par une requête INSERT</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_insert_id</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne l'identifiant généré par la colonne de type DEFAULT UNIQUE, lors + de la dernière requête INSERT. + </para> + <note> <para> - <function>fbsql_insert_id</function> retournera 0 si la dernière - requête n'a pas généré de valeur dans la - colonne DEFAULT UNIQUE. - Si vous devez sauver cette valeur pour plus tard, n'oubliez pas - d'appeler <function>fbsql_insert_id</function> tout de suite - après la requête qui a généré cette valeur. + La valeur de la fonction FrontBase SQL + <function>fbsql_insert_id</function> retourne toujours la dernière + valeur générée par DEFAULT UNIQUE et n'est jamais annulée entre les + requêtes. </para> - <note> - <para> - La valeur de la fonction FrontBase SQL - "<literal>LAST_INSERT_ID()</literal>" retourne toujours la dernière - valeur générée par DEFAULT UNIQUE et n'est jamais annulée entre les - requêtes. - </para> - </note> - </refsect1> - </refentry> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne l'identifiant généré depuis la dernière requête INSERT, ou &zero; + si la dernière requête n'a pas générée une valeur DEFAULT UNIQUE. + </para> + <para> + Si vous devez sauver cette valeur pour plus tard, n'oubliez pas + d'appeler <function>fbsql_insert_id</function> tout de suite + après la requête qui a généré cette valeur. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_affected_rows</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -60,4 +81,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml:1.11 phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml:1.12 --- phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml:1.11 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml Tue Jan 23 19:04:36 2007 @@ -1,60 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-list-dbs"> - <refnamediv> - <refname>fbsql_list_dbs</refname> - <refpurpose> - Liste les bases de données FBSQL - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_list_dbs</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_list_dbs</function> retourne un résultat contenant la - liste des bases de données disponibles sur le serveur - <optional>link_identifier</optional>. Utilisez la fonction - <function>fbsql_tablename</function> pour passer en revue ce - résultat. - </para> - <para> - <example> - <title>Exemple avec <function>fbsql_list_dbs</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-list-dbs"> + <refnamediv> + <refname>fbsql_list_dbs</refname> + <refpurpose>Liste les bases de données FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_list_dbs</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne un résultat contenant la liste des bases de données + disponibles sur le serveur <optional>link_identifier</optional>. + Utilisez la fonction <function>fbsql_tablename</function> pour + passer en revue ce résultat. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un pointeur de résultat ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_list_dbs</function></title> + <programlisting role="php"> <![CDATA[ -<?php $link = fbsql_connect('localhost', 'myname', 'secret'); $db_list = fbsql_list_dbs($link); + while ($row = fbsql_fetch_object($db_list)) { - echo $row->Database . "\n"; + echo $row->Database . "\n"; } -?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ database1 database2 database3 ... ]]> - </screen> - </example> + </screen> + </example> + </para> + <note> + <para> + L'exemple ci-dessus peut aussi bien fonctionner avec la fonction + <function>fbsql_fetch_row</function> ou toute autre similaire. </para> - <note> - <para> - L'exemple ci-dessus peut aussi bien fonctionner avec la fonction - <function>fbsql_fetch_row</function> ou toute autre similaire. - </para> - </note> - </refsect1> - </refentry> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_list_fields</function></member> + <member><function>fbsql_list_tables</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -75,4 +104,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml:1.12 phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml:1.13 --- phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml:1.12 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml Tue Jan 23 19:04:36 2007 @@ -1,67 +1,114 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-list-fields"> - <refnamediv> - <refname>fbsql_list_fields</refname> - <refpurpose>Liste les champs d'un résultat FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_list_fields</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam><type>string</type><parameter>table_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_list_fields</function> lit les informations à propos - de la table <parameter>table_name</parameter>, dans la base de données - <parameter>table_name</parameter>, sur la connexion - <parameter>link_identifier</parameter>. Un résultat de requête est - retourné, et pourra être utilisé avec les fonctions - <function>fbsql_field_flags</function>, - <function>fbsql_field_len</function>, - <function>fbsql_field_name</function> et - <function>fbsql_field_type</function>. - </para> - <para> - Un identifiant de résultat est une ressource &php;, représentée par - un entier positif. <function>fbsql_list_fields</function> retourne - -1 en cas d'erreur. Une chaîne décrivant l'erreur sera alors placée dans - la variable <literal>$phperrmsg</literal>. Un message d'erreur sera - aussi affiché, à moins que la fonction n'ait été appelée avec l'opérateur - de suppression des erreurs @. - </para> - <para> - <example> - <title>Exemple avec <function>fbsql_list_fields</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-list-fields"> + <refnamediv> + <refname>fbsql_list_fields</refname> + <refpurpose>Liste les champs d'une table FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_list_fields</methodname> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam><type>string</type><parameter>table_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Liste les champs d'une table fournie. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database_name</parameter></term> + <listitem> + <para> + Le nom de la base de données. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>table_name</parameter></term> + <listitem> + <para> + Le nom de la table. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un pointeur de résultat qui pourra être utilisé avec les fonctions + <literal>fbsql_field_xxx</literal> ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + Une chaîne décrivant l'erreur sera placée dans la variable + <literal>$phperrmsg</literal>, et ce, même si la fonction a été appelé comme ceci : + <literal>@fbsql()</literal>, puis, l'erreur sera également affichée. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_list_fields</function></title> + <programlisting role="php"> <![CDATA[ <?php -$link = fbsql_connect('localhost', 'monnom', 'secret'); +$link = fbsql_connect('localhost', 'myname', 'secret'); + $fields = fbsql_list_fields("database1", "table1", $link); $columns = fbsql_num_fields($fields); + for ($i = 0; $i < $columns; $i++) { - echo fbsql_field_name($fields, $i) . "\n";; + echo fbsql_field_name($fields, $i) . "\n";; } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ field1 field2 field3 ... ]]> - </screen> - </example> - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_field_len</function></member> + <member><function>fbsql_field_name</function></member> + <member><function>fbsql_field_type</function></member> + <member><function>fbsql_field_flags</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -82,4 +129,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml:1.8 phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml:1.9 --- phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml:1.8 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml Tue Jan 23 19:04:36 2007 @@ -1,28 +1,64 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-list-tables"> - <refnamediv> - <refname>fbsql_list_tables</refname> - <refpurpose>Liste les tables dans une base de données FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_list_tables</methodname> - <methodparam><type>string</type><parameter>database</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_list_tables</function> liste les tables dans la base - de données <parameter>database</parameter>, et retourne un résultat, - tout comme <function>fbsql_db_query</function>. - <function>fbsql_tablename</function> sert à extraire la liste des tables - dans ce résultat. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-list-tables"> + <refnamediv> + <refname>fbsql_list_tables</refname> + <refpurpose>Liste les tables dans une base de données FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_list_tables</methodname> + <methodparam><type>string</type><parameter>database</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne un pointeur de résultat décrivant la base de données + <parameter>database</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database</parameter></term> + <listitem> + <para> + Le nom de la base de données. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un pointeur de résultat qui pourra être utilisé avec la fonction + <function>fbsql_tablename</function> pour lire les noms + des tables ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_list_fields</function></member> + <member><function>fbsql_list_dbs</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -43,4 +79,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml:1.11 phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml:1.12 --- phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml:1.11 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml Tue Jan 23 19:04:36 2007 @@ -1,32 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-next-result"> - <refnamediv> - <refname>fbsql_next_result</refname> - <refpurpose>Déplace le pointeur interne vers le résultat suivant</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_next_result</methodname> - <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> - </methodsynopsis> - <para> - Lorsque vous envoyez plus d'une commande SQL au serveur ou que vous - exécutez une procédure stockée avec de multiples résultats, cela va - conduire le serveur à retourner plusieurs jeux de lignes. - <function>fbsql_next_result</function> va vérifier l'existence de - plusieurs résultats disponibles sur le serveur. Si un autre - jeu de résultats existe, <function>fbsql_next_result</function> va - détruire le résultat précédent et préparer la lecture dans les - nouvelles lignes. - </para> - <para> - <function>fbsql_next_result</function> retourne &true; si - un autre résultat est disponible, ou &false; sinon. - </para> + +<refentry id="function.fbsql-next-result"> + <refnamediv> + <refname>fbsql_next_result</refname> + <refpurpose>Déplace le pointeur interne vers le résultat suivant</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_next_result</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + Lorsque vous envoyez plus d'une commande SQL au serveur ou que vous + exécutez une procédure stockée avec de multiples résultats, cela va + conduire le serveur à retourner plusieurs jeux de lignes. + <function>fbsql_next_result</function> va vérifier l'existence de + plusieurs résultats disponibles sur le serveur. Si un autre + jeu de résultats existe, <function>fbsql_next_result</function> va + détruire le résultat précédent et préparer la lecture dans les + nouvelles lignes. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si un jeu de résultats additionnel est disponible, + &false; sinon. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_next_result</function></title> <programlisting role="php"> @@ -37,17 +57,19 @@ $SQL = "Select * from table1; select * from table2;"; $rs = fbsql_query($SQL, $link); do { - while ($row = fbsql_fetch_row($rs)) {} + while ($row = fbsql_fetch_row($rs)) { + } } while (fbsql_next_result($rs)); - fbsql_free_result($rs); fbsql_close($link); ?> ]]> </programlisting> </example> - </refsect1> - </refentry> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -68,4 +90,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml:1.7 phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml:1.8 --- phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml:1.7 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml Tue Jan 23 19:04:36 2007 @@ -1,31 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-num-fields"> - <refnamediv> - <refname>fbsql_num_fields</refname> - <refpurpose>Lit le nombre de champs dans un résultat</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_num_fields</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_num_fields</function> retourne le nombre de champs - dans le résultat <parameter>result</parameter>. - </para> - <para> - Voir aussi - <function>fbsql_db_query</function>, - <function>fbsql_query</function>, - <function>fbsql_fetch_field</function> et - <function>fbsql_num_rows</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-num-fields"> + <refnamediv> + <refname>fbsql_num_fields</refname> + <refpurpose>Lit le nombre de champs dans un résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_num_fields</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le nombre de champs dans le résultat <parameter>result</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nombre de champs, sous la forme d'un &integer;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_db_query</function></member> + <member><function>fbsql_query</function></member> + <member><function>fbsql_fetch_field</function></member> + <member><function>fbsql_num_rows</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +69,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml Tue Jan 23 19:04:36 2007 @@ -1,50 +1,83 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-num-rows"> - <refnamediv> - <refname>fbsql_num_rows</refname> - <refpurpose>Lit le nombre de lignes dans un résultat</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_num_rows</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_num_rows</function> retourne le nombre de lignes - dans le résultat <parameter>result</parameter>. Cette fonction - n'est valable qu'avec les commandes SELECT. Pour connaître le nombre - de lignes dans une requête INSERT, UPDATE ou DELETE, utilisez - <function>fbsql_affected_rows</function>. - <example> - <title>Exemple <function>fbsql_num_rows</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-num-rows"> + <refnamediv> + <refname>fbsql_num_rows</refname> + <refpurpose>Lit le nombre de lignes dans un résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_num_rows</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + Lit le nombre de lignes dans le jeu de résultats <parameter>result</parameter>. + </para> + <para> + Cette fonction n'est valable qu'avec les commandes SELECT. Pour connaître le nombre + de lignes dans une requête INSERT, UPDATE ou DELETE, utilisez + <function>fbsql_affected_rows</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nombre de lignes retourné par la dernière requête SELECT. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_num_rows</function></title> + <programlisting role="php"> <![CDATA[ <?php -$link = fbsql_connect('localhost', 'utilisateur', 'password'); + +$link = fbsql_connect("localhost", "username", "password"); fbsql_select_db("database", $link); $result = fbsql_query("SELECT * FROM table1;", $link); $num_rows = fbsql_num_rows($result); echo "$num_rows lignes\n"; + ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>fbsql_affected_rows</function>, - <function>fbsql_connect</function>, - <function>fbsql_select_db</function> et - <function>fbsql_query</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_affected_rows</function></member> + <member><function>fbsql_connect</function></member> + <member><function>fbsql_select_db</function></member> + <member><function>fbsql_query</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -65,4 +98,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-password.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-password.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-password.xml:1.6 phpdoc-fr/reference/fbsql/functions/fbsql-password.xml:1.7 --- phpdoc-fr/reference/fbsql/functions/fbsql-password.xml:1.6 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-password.xml Tue Jan 23 19:04:36 2007 @@ -1,24 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-password"> - <refnamediv> - <refname>fbsql_password</refname> - <refpurpose>Lit ou définit le mot de passe à utiliser avec une connexion</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_password</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-password'> + <refnamediv> + <refname>fbsql_password</refname> + <refpurpose>Lit ou définit le mot de passe à utiliser avec une connexion</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_password</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> + </methodsynopsis> + <para> + Lit ou définit le mot de passe à utiliser avec une connexion. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Si fourni, il sera le nouveau mot de passe pour la connexion. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le mot de passe courant pour la connexion. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_username</function></member> + <member><function>fbsql_hostname</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -39,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml Tue Jan 23 19:04:36 2007 @@ -1,61 +1,102 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-pconnect"> - <refnamediv> - <refname>fbsql_pconnect</refname> - <refpurpose> - Ouvre une connexion persistante à un serveur FrontBase - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_pconnect</methodname> - <methodparam choice="opt"><type>string</type><parameter>hostname</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_pconnect</function> retourne une ressource représentant - la connexion au serveur FrontBase en cas de succès, ou bien - &false; en cas d'erreur. - </para> - <para> - <function>fbsql_pconnect</function> établit une connexion - persistante à un serveur FrontBase. En cas d'omission, les valeurs - suivantes sont utilisées par défaut : - <parameter>host</parameter> ='localhost', - <parameter>username</parameter> = nom de l'utilisateur qui possède - le processus, et <parameter>password</parameter> = pas de mot de passe. - </para> - <para> - Pour choisir le port d'accès au serveur FrontBase, voyez - <function>fbsql_select_db</function>. - </para> - <para> - <function>fbsql_pconnect</function> se comporte comme - <function>fbsql_connect</function> avec deux différences majeures. - </para> - <para> - Premièrement, lors de la connexion, <function>fbsql_pconnect</function> - essaie de trouver une connexion permanante déjà ouverte sur - cet hôte, avec les mêmes nom d'utilisateur et mot de passe. Si une - telle connexion est trouvée, son identifiant est retourné - sans ouvrir de nouvelle connexion. - </para> - <para> - Deuxièmement, la connexion au serveur fbssl ne sera pas terminée avec la fin - du script. Au lieu de cela, le lien sera conservé pour un prochain accès - (<function>fbsql_close</function> ne terminera pas une connexion persistante - établie par <function>fbsql_pconnect</function>). - </para> - <para> - C'est pourquoi ce type de connexion est dit 'persistant'. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-pconnect"> + <refnamediv> + <refname>fbsql_pconnect</refname> + <refpurpose>Ouvre une connexion persistante sur un serveur FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_pconnect</methodname> + <methodparam choice="opt"><type>string</type><parameter>hostname</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> + </methodsynopsis> + <para> + Ouvre une connexion persistante sur un serveur FrontBase. + </para> + <para> + Pour choisir le port d'accès au serveur FrontBase, voyez + <function>fbsql_select_db</function>. + </para> + <para> + <function>fbsql_pconnect</function> se comporte comme + <function>fbsql_connect</function> avec deux différences majeures : + </para> + <para> + Premièrement, lors de la connexion, <function>fbsql_pconnect</function> + essaie de trouver une connexion permanante déjà ouverte sur + cet hôte, avec les mêmes nom d'utilisateur et mot de passe. Si une + telle connexion est trouvée, son identifiant est retourné + sans ouvrir de nouvelle connexion. + </para> + <para> + Deuxièmement, la connexion au serveur fbssl ne sera pas terminée avec la fin + du script. Au lieu de cela, le lien sera conservé pour un prochain accès + (<function>fbsql_close</function> ne terminera pas une connexion persistante + établie par <function>fbsql_pconnect</function>). + </para> + <para> + C'est pourquoi ce type de connexion est dit 'persistant'. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hostname</parameter></term> + <listitem> + <para> + Le nom de l'hôte du serveur. Par défaut, c'est <literal>localhost</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>username</parameter></term> + <listitem> + <para> + Le nom d'utilisateur pour la connexion. Par défaut, c'est + <literal>_SYSTEM</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Le mot de passe pour la connexion. Par défaut, c'est une chaîne vide. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un identifiant de connexion persistant FrontBase en cas de succès, + ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_connect</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -76,4 +117,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-query.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-query.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-query.xml:1.13 phpdoc-fr/reference/fbsql/functions/fbsql-query.xml:1.14 --- phpdoc-fr/reference/fbsql/functions/fbsql-query.xml:1.13 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-query.xml Tue Jan 23 19:04:36 2007 @@ -1,105 +1,137 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-query"> - <refnamediv> - <refname>fbsql_query</refname> - <refpurpose>Exécute une requête sur un serveur FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_query</methodname> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>batch_size</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_query</function> envoie la requête - <parameter>query</parameter> à la base de données courante, - sur le serveur représenté par sa connexion <parameter>link_identifier</parameter>. - Si <parameter>link_identifier</parameter> est omis, la dernière - connexion ouverte est utilisée. Si aucune connexion n'a été ouverte, - <function>fbsql_query</function> essaie d'établir une connexion en - appelant la fonction <function>fbsql_connect</function> sans - aucun argument. - </para> - <note> - <para> - La requête doit être terminée par un point-virgule ! - </para> - </note> - <para> - <function>fbsql_query</function> retourne une ressource - en cas de succès, ou &false;, en cas - d'échec. Si &true; est retourné, cela signifie que la requête est correct et qu'elle - peut être exécutée par le serveur. Cela n'indique rien sur le nombre de lignes - concernées ou retournées. Il est tout à fait possible qu'une requête réussisse mais - qu'aucune ligne ne soit affectée ni retournée. - </para> + +<refentry id="function.fbsql-query"> + <refnamediv> + <refname>fbsql_query</refname> + <refpurpose>Exécute une requête sur un serveur FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_query</methodname> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>batch_size</parameter></methodparam> + </methodsynopsis> + <para> + Envoie la requête <parameter>query</parameter> à la base de données + courante, sur le serveur. + </para> + <para> + Lorsque la requête réussit, vous pouvez utilisez + <function>fbsql_num_rows</function> pour savoir combien de + lignes ont été retournées par une requête SELECT, ou + <function>fbsql_affected_rows</function> pour les autres + requêtes (DELETE, INSERT, REPLACE et UPDATE). + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>query</parameter></term> + <listitem> + <para> + La requête SQL à exécuter. + </para> + <note> + <para> + La requête doit toujours se terminer par un point virgule. + </para> + </note> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>batch_size</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <function>fbsql_query</function> retourne une ressource + en cas de succès, ou &false;, en cas d'échec. Si &true; est + retourné, cela signifie que la requête est correct et qu'elle peut + être exécutée par le serveur. Cela n'indique rien sur le nombre + de lignes concernées ou retournées. Il est tout à fait possible + qu'une requête réussisse mais qu'aucune ligne ne soit affectée + ni retournée. + </para> + <para> + Pour les requêtes SELECT, <function>fbsql_query</function> retourne + une ressource de résultat, que vous pouvez passer à + <function>fbsql_result</function>. + </para> + <para> + <function>fbsql_query</function> échouera si vous n'avez pas + les droits d'accès sur l'une des bases de données utilisées dans + la requête. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> - La requête suivante est invalide, et <function>fbsql_query</function> - échouera puis retournera &false;: - <example> - <title>Exemple avec <function>fbsql_query</function>(1)</title> - <programlisting role="php"> + La requête suivante est invalide, et <function>fbsql_query</function> + échouera puis retournera &false; : + <example> + <title>Exemple avec <function>fbsql_query</function></title> + <programlisting role="php"> <![CDATA[ <?php -$result = fbsql_query("SELECT * WHERE 1=1;") - or die("Requête invalide"); +$result = fbsql_query("SELECT * WHERE 1=1") + or die ("Requête invalide"); ?> ]]> - </programlisting> - </example> - </para> - <para> - La requête suivante est invalide si <literal>my_col</literal> n'est pas - une colonne dans la table <literal>my_tbl</literal> : <function>fbsql_query</function> - échouera puis retournera &false; : - <example> - <title>Exemple avec <function>fbsql_query</function>(2)</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + La requête suivante est invalide si <literal>my_col</literal> n'est pas + une colonne dans la table <literal>my_tbl</literal> : <function>fbsql_query</function> + échouera puis retournera &false; : + <example> + <title>Exemple avec <function>fbsql_query</function></title> + <programlisting role="php"> <![CDATA[ <?php -$result = fbsql_query("SELECT my_col FROM my_tbl") +$result = fbsql_query ("SELECT my_col FROM my_tbl;") or die ("Requête invalide"); ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>fbsql_query</function> échouera si vous n'avez pas - les droits d'accès sur l'une des bases de données utilisées dans - la requête. - </para> - <para> - Lorsque la requête réussit, vous pouvez utilisez - <function>fbsql_num_rows</function> pour savoir combien de - lignes ont été retournées par une requête SELECT, ou - <function>fbsql_affected_rows</function> pour les autres - requêtes (DELETE, INSERT, REPLACE et UPDATE). - </para> - <para> - Pour les requêtes SELECT, <function>fbsql_query</function> retourne - une ressource de résultat, que vous pouvez passer à <function>fbsql_result</function>. - Lorsque vous avez fini de lire le résultat, vous pouvez libérer les - ressources utilisées en appelant - <function>fbsql_free_result</function>. Cependant, la mémoire sera automatiquement - libérée à la fin du script. - </para> - <para> - Voir aussi - <function>fbsql_affected_rows</function>, - <function>fbsql_db_query</function>, - <function>fbsql_free_result</function>, - <function>fbsql_result</function>, - <function>fbsql_select_db</function> et - <function>fbsql_connect</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_affected_rows</function></member> + <member><function>fbsql_db_query</function></member> + <member><function>fbsql_free_result</function></member> + <member><function>fbsql_result</function></member> + <member><function>fbsql_select_db</function></member> + <member><function>fbsql_connect</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -120,4 +152,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml:1.12 phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml:1.13 --- phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml:1.12 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml Tue Jan 23 19:04:36 2007 @@ -1,71 +1,104 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-read-blob"> - <refnamediv> - <refname>fbsql_read_blob</refname> - <refpurpose>Lit un BLOB dans une base de données</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_read_blob</methodname> - <methodparam><type>string</type><parameter>blob_handle</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_read_blob</function> retourne une chaîne de caractères - contenant le BLOB <parameter>blob_handle</parameter>. - </para> - <para> - <function>fbsql_read_blob</function> lit les données du BLOB dans - la base de données. Si une sélection contient une colonne - de type BLOB et/ou de type CLOB, FrontBase retournera directement les - données lors de la lecture. Ce comportement par défaut peut être - modifié avec la fonction <function>fbsql_set_lob_mode</function> pour que - les fonctions de lecture ne retournent qu'un identifiant de - BLOB ou CLOB. Si un identifiant est lu, il faut utiliser la fonction - <function>fbsql_read_blob</function> pour obtenir la valeur du BLOB. - </para> + +<refentry id="function.fbsql-read-blob"> + <refnamediv> + <refname>fbsql_read_blob</refname> + <refpurpose>Lit un BLOB dans une base de données</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_read_blob</methodname> + <methodparam><type>string</type><parameter>blob_handle</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Lit un BLOB d'une base de données. + </para> + <para> + Si une sélection contient une colonne de type BLOB et/ou de type + CLOB, FrontBase retournera directement les données lors de la + lecture. Ce comportement par défaut peut être modifié avec la + fonction <function>fbsql_set_lob_mode</function> pour que + les fonctions de lecture ne retournent qu'un identifiant de BLOB + ou CLOB. Si un identifiant est lu, il faut utiliser la fonction + <function>fbsql_read_blob</function> pour obtenir la valeur du BLOB. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>blob_handle</parameter></term> + <listitem> + <para> + Un gestionnaire BLOB, retourné par la fonction + <function>fbsql_create_blob</function>. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une &string; contenant les données du BLOB spécifié. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_read_blob</function></title> <programlisting role="php"> <![CDATA[ <?php - -$link = fbsql_pconnect ("localhost", "_SYSTEM", "secret") - or die ("Impossible de se connecter"); - +$link = fbsql_pconnect("localhost", "_SYSTEM", "secret") + or die("Impossible de se connecter"); $sql = "SELECT BLOB_COLUMN FROM BLOB_TABLE;"; $rs = fbsql_query($sql, $link); $row_data = fbsql_fetch_row($rs); - // $row_data[0] contiendra maintenant les données du blob de la première // ligne - fbsql_free_result($rs); + $rs = fbsql_query($sql, $link); fbsql_set_lob_mode($rs, FBSQL_LOB_HANDLE); $row_data = fbsql_fetch_row($rs); - -// $row_data[0] contiendra maintenant un identifiant vers les données du -// blob de la première ligne - +// $row_data[0] contient maintenant un gestionnaire vers les données BLOB +// dans la première ligne $blob_data = fbsql_read_blob($row_data[0]); fbsql_free_result($rs); + ?> ]]> </programlisting> </example> - <para> - Voir aussi - <function>fbsql_create_blob</function>, - <function>fbsql_read_clob</function> et - <function>fbsql_set_lob_mode</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_create_blob</function></member> + <member><function>fbsql_read_clob</function></member> + <member><function>fbsql_set_lob_mode</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml:1.12 phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml:1.13 --- phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml:1.12 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml Tue Jan 23 19:04:36 2007 @@ -1,71 +1,104 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-read-clob"> - <refnamediv> - <refname>fbsql_read_clob</refname> - <refpurpose>Lit un CLOB dans une base de données</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_read_clob</methodname> - <methodparam><type>string</type><parameter>clob_handle</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_read_clob</function> retourne une chaîne de caractères - contenant le CLOB <parameter>clob_handle</parameter>. - </para> - <para> - <function>fbsql_read_clob</function> lit les données du CLOB dans - la base de données. Si une sélection contient une colonne - de type CLOB et/ou de type BLOB, FrontBase retournera directement les - données lors de la lecture. Ce comportement par défaut peut être - modifié avec la fonction <function>fbsql_set_lob_mode</function> pour que - les fonctions de lecture ne retournent qu'un identifiant de - BLOB ou CLOB. Si un identifiant est lu, il faut utiliser la fonction - <function>fbsql_read_clob</function> pour obtenir la valeur du CLOB. - </para> + +<refentry id="function.fbsql-read-clob"> + <refnamediv> + <refname>fbsql_read_clob</refname> + <refpurpose>Lit un CLOB dans une base de données</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_read_clob</methodname> + <methodparam><type>string</type><parameter>clob_handle</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Lit un CLOB d'une base de données. + </para> + <para> + Si une sélection contient une colonne de type CLOB et/ou de type + BLOB, FrontBase retournera directement les données lors de la + lecture. Ce comportement par défaut peut être modifié avec la + fonction <function>fbsql_set_lob_mode</function> pour que + les fonctions de lecture ne retournent qu'un identifiant de BLOB + ou CLOB. Si un identifiant est lu, il faut utiliser la fonction + <function>fbsql_read_clob</function> pour obtenir la valeur du CLOB. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>clob_handle</parameter></term> + <listitem> + <para> + Un gestionnaire CLOB, retourné par la fonction + <function>fbsql_create_clob</function>. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une &string; contenant les données du CLOB spécifié. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_read_clob</function></title> <programlisting role="php"> <![CDATA[ <?php - -$link = fbsql_pconnect ("localhost", "_SYSTEM", "secret") - or die ("Impossible de se connecter"); - +$link = fbsql_pconnect("localhost", "_SYSTEM", "secret") + or die("Impossible de se connecter"); $sql = "SELECT CLOB_COLUMN FROM CLOB_TABLE;"; $rs = fbsql_query($sql, $link); $row_data = fbsql_fetch_row($rs); - // $row_data[0] contiendra maintenant les données du blob de la // première ligne - fbsql_free_result($rs); + $rs = fbsql_query($sql, $link); fbsql_set_lob_mode($rs, FBSQL_LOB_HANDLE); $row_data = fbsql_fetch_row($rs); - // $row_data[0] contiendra maintenant un identifiant vers les // données du clob de la première ligne - $clob_data = fbsql_read_clob($row_data[0]); fbsql_free_result($rs); + ?> ]]> </programlisting> </example> - <para> - Voir aussi - <function>fbsql_create_blob</function>, - <function>fbsql_read_blob</function> et - <function>fbsql_set_lob_mode</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_create_clob</function></member> + <member><function>fbsql_read_blob</function></member> + <member><function>fbsql_set_lob_mode</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -86,4 +119,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-result.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-result.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-result.xml:1.11 phpdoc-fr/reference/fbsql/functions/fbsql-result.xml:1.12 --- phpdoc-fr/reference/fbsql/functions/fbsql-result.xml:1.11 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-result.xml Tue Jan 23 19:04:36 2007 @@ -1,49 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-result"> - <refnamediv> - <refname>fbsql_result</refname> - <refpurpose>Lit des données dans un résultat</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>fbsql_result</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>field</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_result</function> lit le contenu du champ - <parameter>field</parameter>, dans la ligne <parameter>row</parameter>, - du résultat <parameter>result</parameter>. L'argument - <parameter>field</parameter> peut être l'index du champ, ou bien - son nom, ou bien le nom de sa table plus point plus son nom. Si la - colonne a été aliasée, utilisez de préférence l'alias. - </para> - <para> - Lorsque vous travaillez sur de grands résultats, il est vivement - recommandé d'utiliser les fonctions qui lisent toute une ligne - d'un coup, plutôt que <function>fbsql_result</function> qui - travaille ligne par ligne. Elles sont beaucoup plus rapides. Notez aussi - que les offset numériques sont plus rapides que les offset - nominaux. - </para> - <para> - L'utilisation de <function>fbsql_result</function> ne doit pas - être mélangée avec d'autres fonctions qui utilisent aussi le résultat - <parameter>result</parameter>. - </para> - <para> - Alternatives vivement recommandées : - <function>fbsql_fetch_row</function>, - <function>fbsql_fetch_array</function> et - <function>fbsql_fetch_object</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-result"> + <refnamediv> + <refname>fbsql_result</refname> + <refpurpose>Lit des données dans un résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>fbsql_result</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>field</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le contenu d'une cellule depuis un jeu de résultat FrontBase. + </para> + <para> + Lorsque vous travaillez sur de grands résultats, il est vivement + recommandé d'utiliser les fonctions qui lisent toute une ligne + d'un coup, plutôt que <function>fbsql_result</function> qui + travaille ligne par ligne. Elles sont beaucoup plus rapides. Notez aussi + que les offset numériques sont plus rapides que les offset + nominaux. + </para> + <para> + L'utilisation de <function>fbsql_result</function> ne doit pas + être mélangée avec d'autres fonctions qui utilisent aussi le résultat + <parameter>result</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>row</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>field</parameter></term> + <listitem> + <para> + Peut être la position du champs ou le nom du champs, ou le + nom de la table, suivi d'un point, suivi du nom du champs + (tabledname.fieldname). + </para> + <para> + Si l'on n'utilise pas d'aliase ('select foo as bar from...'), + utilisez plutôt le nom de la colonne. + </para> + <note> + <para> + Le fait de spécifier une position numérique pour l'argument du champs + est plus rapide que de spécifier le nom du champs ou la forme + tablename.fieldname comme argument. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + Alternatives vivement recommandées : + <simplelist> + <member><function>fbsql_fetch_row</function></member> + <member><function>fbsql_fetch_array</function></member> + <member><function>fbsql_fetch_assoc</function></member> + <member><function>fbsql_fetch_object</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -64,4 +112,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml Tue Jan 23 19:04:36 2007 @@ -1,34 +1,57 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-rollback"> - <refnamediv> - <refname>fbsql_rollback</refname> - <refpurpose>Annule une transaction FBSQL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_rollback</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_rollback</function> termine la transaction - courante en annulant toutes les requêtes émises depuis la - dernière validation. Cette commande n'est utile que si FrontBase - est en mode de validation manuelle. - </para> - <para> - &return.success; - </para> - <para> - Voir aussi - <function>fbsql_autocommit</function> et - <function>fbsql_commit</function> - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-rollback"> + <refnamediv> + <refname>fbsql_rollback</refname> + <refpurpose>Annule une transaction FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_rollback</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Termine la transaction courante en annulant toutes les requêtes + émises depuis la dernière validation. + </para> + <para> + Cette commande n'est utile que si FrontBase est en mode de + validation manuelle. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_autocommit</function></member> + <member><function>fbsql_commit</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -49,4 +72,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml Tue Jan 23 19:04:36 2007 @@ -1,57 +1,82 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-select-db"> - <refnamediv> - <refname>fbsql_select_db</refname> - <refpurpose>Sélectionne une base de données FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_select_db</methodname> - <methodparam choice="opt"><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_select_db</function> remplace la base de données - active courante par <parameter>database_name</parameter>, sur la - connexion ouverte et représentée par <parameter>link_identifier</parameter>. - Si <parameter>link_identifier</parameter> est omis, la dernière - connexion ouverte sera utilisée. Si aucune connexion n'a été ouverte, - <function>fbsql_select_db</function> essaiera de se connecter - en appelant <function>fbsql_connect</function> sans arguments. - </para> - <para> - &return.success; - </para> - <para> - Le client contacte FBExec pour connaître le numéro de port à utiliser - pour la connexion à la base de données. Si le nom de la base est un - numéro, le système l'utilisera comme numéro de port, et ne - le demandera pas à FBExec. Le serveur Frontbase peut être - démarré avec la commande : - <literal>FRontBase -FBExec=No -port=<port number> <database name></literal>. - </para> - <para> - Tous les prochains appels à <function>fbsql_query</function> se feront - dans la base <parameter>database_name</parameter>. - </para> - <para> - Si la base de données est protégée avec un mot de passe, l'utilisateur doit - appeler la fonction <function>fbsql_database_password</function> avant - de sélectionner la base de données. - </para> - <para> - Voir aussi - <function>fbsql_database_password</function>, - <function>fbsql_connect</function>, - <function>fbsql_pconnect</function> et - <function>fbsql_query</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-select-db"> + <refnamediv> + <refname>fbsql_select_db</refname> + <refpurpose>Sélectionne une base de données FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_select_db</methodname> + <methodparam choice="opt"><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Sélectionne une base de données FrontBase. + </para> + <para> + Le client contacte FBExec pour connaître le numéro de port à utiliser + pour la connexion à la base de données. Si le nom de la base est un + numéro, le système l'utilisera comme numéro de port, et ne + le demandera pas à FBExec. Le serveur Frontbase peut être + démarré avec la commande : + <literal>FRontBase -FBExec=No -port=<port number> + <database name></literal>. + </para> + <para> + Tous les prochains appels à <function>fbsql_query</function> se feront + dans la base <parameter>database_name</parameter>. + </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database_name</parameter></term> + <listitem> + <para> + Le nom de la base de données à sélectionner. + </para> + <para> + Si la base de données est protégée avec un mot de passe, l'utilisateur doit + appeler la fonction <function>fbsql_database_password</function> avant + de sélectionner la base de données. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_connect</function></member> + <member><function>fbsql_pconnect</function></member> + <member><function>fbsql_database_password</function></member> + <member><function>fbsql_query</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -72,4 +97,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml Tue Jan 23 19:04:36 2007 @@ -1,65 +1,93 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-set-lob-mode"> - <refnamediv> - <refname>fbsql_set_lob_mode</refname> - <refpurpose> - Modifie le mode de lecture des LOB - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_set_lob_mode</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_set_lob_mode</function> retourne &true; - en cas de succès et &false; sinon. - </para> - <para> - <function>fbsql_set_lob_mode</function> modifie le mode de lecture - des LOB. Lorsque des données BLOB ou CLOB sont stockées dans une - base de données FrontBase, elles peuvent l'être de manière directe ou - indirecte. Si les données sont stockées directement, elles seront - automatiquement lues, quelque soit le mode choisi. Si un LOB fait - moins de 512 octets, il sera aussi stocké directement. - <itemizedlist> - <listitem> - <simpara> - FBSQL_LOB_DIRECT - les données LOB sont lues directements. - Lorsque les données sont lues dans la base avec - <function>fbsql_fetch_row</function> ou d'autres fonctions de lectures, - toutes les colonnes de type CLOB et BLOB seront retournées comme - des colonnes habituelles. C'est le comportement par défaut de - FrontBase. - </simpara> - </listitem> + +<refentry id="function.fbsql-set-lob-mode"> + <refnamediv> + <refname>fbsql_set_lob_mode</refname> + <refpurpose>Modifie le mode de lecture des LOB</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_set_lob_mode</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>lob_mode</parameter></methodparam> + </methodsynopsis> + <para> + Modifie le mode de lecture des LOB depuis la base de données. + </para> + <para> + Lorsque des données BLOB ou CLOB sont stockées dans une + base de données FrontBase, elles peuvent l'être de manière directe ou + indirecte. Si les données sont stockées directement, elles seront + automatiquement lues, quelque soit le mode choisi. Si un LOB fait + moins de 512 octets, il sera aussi stocké directement. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>lob_mode</parameter></term> <listitem> - <simpara> - FBSQL_LOB_HANDLE - Les données LOB sont lues sous forme - d'identifiants. Lorsque les données sont lues dans la base avec - <function>fbsql_fetch_row</function> ou d'autres fonctions de lecture, - toutes les colonnes de type CLOB et BLOB seront retournées - sous la forme d'un identifiant. Cet identifiant sera une chaîne de - 27 caractères de long, formatée comme ceci : - <literal>"@'000000000000000000000000'"</literal>. - </simpara> + <para> + Peut être un parmis : + <itemizedlist> + <listitem> + <simpara> + <constant>FBSQL_LOB_DIRECT</constant> - les données LOB sont lues directements. + Lorsque les données sont lues dans la base avec + <function>fbsql_fetch_row</function> ou d'autres fonctions de lectures, + toutes les colonnes de type CLOB et BLOB seront retournées comme + des colonnes habituelles. C'est le comportement par défaut de + FrontBase. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FBSQL_LOB_HANDLE</constant> - Les données LOB sont lues sous forme + d'identifiants. Lorsque les données sont lues dans la base avec + <function>fbsql_fetch_row</function> ou d'autres fonctions de lecture, + toutes les colonnes de type CLOB et BLOB seront retournées + sous la forme d'un identifiant. Cet identifiant sera une chaîne de + 27 caractères de long, formatée comme ceci : + <literal>"@'000000000000000000000000'"</literal>. + </simpara> + </listitem> + </itemizedlist> + </para> </listitem> - </itemizedlist> - </para> - <para> - Voir aussi - <function>fbsql_create_blob</function>, - <function>fbsql_create_clob</function>, - <function>fbsql_read_blob</function> et - <function>fbsql_read_clob</function>. - </para> - </refsect1> - </refentry> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_create_blob</function></member> + <member><function>fbsql_create_clob</function></member> + <member><function>fbsql_read_blob</function></member> + <member><function>fbsql_read_clob</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -80,4 +108,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml:1.3 phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml:1.4 --- phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml:1.3 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml Tue Jan 23 19:04:36 2007 @@ -1,28 +1,68 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-set-password"> - <refnamediv> - <refname>fbsql_set_password</refname> - <refpurpose> - Change le mot de passe de l'utilisateur spécifié - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_set_password</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam><type>string</type><parameter>user</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam><type>string</type><parameter>old_password</parameter></methodparam> - </methodsynopsis> - &warn.undocumented.func; +<refentry id="function.fbsql-set-password"> + <refnamediv> + <refname>fbsql_set_password</refname> + <refpurpose>Change le mot de passe de l'utilisateur spécifié</refpurpose> + </refnamediv> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_set_password</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam><type>string</type><parameter>user</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam><type>string</type><parameter>old_password</parameter></methodparam> + </methodsynopsis> + <para> + Change le mot de passe de l'utilisateur <parameter>user</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>user</parameter></term> + <listitem> + <para> + Le nom de l'utilisateur. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Le nouveau mot de passe à définir. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>old_password</parameter></term> + <listitem> + <para> + L'ancien mot de passe à remplacer. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -43,4 +83,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml:1.8 phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml:1.9 --- phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml:1.8 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml Tue Jan 23 19:04:36 2007 @@ -1,27 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-set-transaction"> - <refnamediv> - <refname>fbsql_set_transaction</refname> - <refpurpose> - Configure le verrouillage et l'isolation de transactions - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>void</type><methodname>fbsql_set_transaction</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>Locking</parameter></methodparam> - <methodparam><type>int</type><parameter>Isolation</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-set-transaction'> + <refnamediv> + <refname>fbsql_set_transaction</refname> + <refpurpose>Configure le verrouillage et l'isolation de transactions</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>fbsql_set_transaction</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam><type>int</type><parameter>locking</parameter></methodparam> + <methodparam><type>int</type><parameter>isolation</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>locking</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>isolation</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -42,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml Tue Jan 23 19:04:36 2007 @@ -1,35 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-start-db"> - <refnamediv> - <refname>fbsql_start_db</refname> - <refpurpose>Démarre une base de données FBSQL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_start_db</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>database_options</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_start_db</function> démarre la base de données - <parameter>database_name</parameter> sur la connexion - <parameter>link_identifier</parameter>. - </para> - <para> - &return.success; - </para> - <para> - Voir aussi - <function>fbsql_db_status</function> et - <function>fbsql_stop_db</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-start-db"> + <refnamediv> + <refname>fbsql_start_db</refname> + <refpurpose>Démarre une base de données FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_start_db</methodname> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>database_options</parameter></methodparam> + </methodsynopsis> + <para> + Démarre une base de données FBSQL. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database_name</parameter></term> + <listitem> + <para> + Le nom de la base de données. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>database_options</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_db_status</function></member> + <member><function>fbsql_stop_db</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -50,4 +84,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml Tue Jan 23 19:04:36 2007 @@ -1,34 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-stop-db"> - <refnamediv> - <refname>fbsql_stop_db</refname> - <refpurpose>Stoppe une base de données FBSQL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_stop_db</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_stop_db</function> stoppe la base de données - <parameter>database_name</parameter> sur la connexion - <parameter>link_identifier</parameter>. - </para> - <para> - &return.success; - </para> - <para> - Voir aussi - <function>fbsql_db_status</function> et - <function>fbsql_start_db</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-stop-db"> + <refnamediv> + <refname>fbsql_stop_db</refname> + <refpurpose>Stoppe une base de données FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_stop_db</methodname> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Stoppe une base de données FBSQL sur un serveur local ou distant. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database_name</parameter></term> + <listitem> + <para> + Le nom de la base de données. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_db_status</function></member> + <member><function>fbsql_start_db</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -49,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml Tue Jan 23 19:04:36 2007 @@ -1,45 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-tablename"> - <refnamediv> - <refname>fbsql_tablename</refname> - <refpurpose>Lit le nom de la table d'un champ</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_tablename</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam><type>int</type><parameter>i</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_tablename</function> retourne le nom de la - table d'origine du champ <parameter>i</parameter>, dans le résultat - <parameter>result</parameter>. La fonction <function>fbsql_num_rows</function> - peut être utilisée pour connaître le nombre de tables dans un - résultat. - <example> - <title>Exemple avec <function>fbsql_tablename</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-tablename"> + <refnamediv> + <refname>fbsql_tablename</refname> + <refpurpose>Lit le nom de la table d'un champs</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_tablename</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>i</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_tablename</function> retourne le nom de la + table d'origine du champs <parameter>i</parameter>, dans le résultat + <parameter>result</parameter>. + </para> + <para> + La fonction <function>fbsql_num_rows</function> + peut être utilisée pour connaître le nombre de tables dans un + résultat. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result</parameter></term> + <listitem> + <para> + Un pointeur de résultat, retourné par la fonction + <function>fbsql_list_tables</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>i</parameter></term> + <listitem> + <para> + Index du champs de la table courante. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de la table, sous la forme d'une &string;. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_tablename</function></title> + <programlisting role="php"> <![CDATA[ <?php fbsql_connect("localhost", "_SYSTEM", ""); $result = fbsql_list_tables("wisconsin"); $i = 0; while ($i < fbsql_num_rows($result)) { - $tb_names[$i] = fbsql_tablename($result, $i); - echo $tb_names[$i] . "<br />"; - $i++; + $tb_names[$i] = fbsql_tablename($result, $i); + echo $tb_names[$i] . "<br />"; + $i++; } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -60,4 +104,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-username.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-username.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-username.xml:1.6 phpdoc-fr/reference/fbsql/functions/fbsql-username.xml:1.7 --- phpdoc-fr/reference/fbsql/functions/fbsql-username.xml:1.6 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-username.xml Tue Jan 23 19:04:36 2007 @@ -1,24 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-username"> - <refnamediv> - <refname>fbsql_username</refname> - <refpurpose>Lit ou définit le nom de login à utiliser avec une connexion</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_username</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-username'> + <refnamediv> + <refname>fbsql_username</refname> + <refpurpose>Lit ou définit le nom de login à utiliser avec une connexion</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_username</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> + </methodsynopsis> + <para> + Lit ou définit le nom de login à utiliser avec la connexion. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>username</parameter></term> + <listitem> + <para> + Si fourni, il sera le nouveau nom de l'utilisateur à définir. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de l'utilisateur courant utilisé avec la connexion, + sous la forme d'une &string;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_password</function></member> + <member><function>fbsql_hostname</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -39,4 +77,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml Tue Jan 23 19:04:36 2007 @@ -1,29 +1,59 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-warnings"> - <refnamediv> - <refname>fbsql_warnings</refname> - <refpurpose>Active ou désactive les alertes FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_warnings</methodname> - <methodparam choice="opt"><type>bool</type><parameter>OnOff</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_warnings</function> retourne &true; si - les alertes sont actives et &false; en cas d'erreur. - </para> - <para> - <function>fbsql_warnings</function> active ou désactive les alertes - FrontBase suivant que <parameter>onoff</parameter> est à &true; - ou &false;. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-warnings"> + <refnamediv> + <refname>fbsql_warnings</refname> + <refpurpose>Active ou désactive les alertes FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_warnings</methodname> + <methodparam choice="opt"><type>bool</type><parameter>OnOff</parameter></methodparam> + </methodsynopsis> + <para> + Active ou désactive les alertes FrontBase. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>OnOff</parameter></term> + <listitem> + <para> + Si l'on doit activer ou non les alertes. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si les alertes sont actives, &false; sinon. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_errno</function></member> + <member><function>fbsql_error</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -44,4 +74,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-fetch-object.xml Tue Jan 23 19:04:36 2007 @@ -1,62 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-fetch-object"> - <refnamediv> - <refname>fbsql_fetch_object</refname> - <refpurpose>Lit une ligne de résultat sous forme d'objet</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>object</type><methodname>fbsql_fetch_object</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_fetch_object</function> retourne un objet dont - les propriétés représentent les colonnes de la ligne à lire, dans - le résultat <parameter>result</parameter>, ou &false; - s'il n'y a pas de ligne à lire. - </para> - <para> - <function>fbsql_fetch_object</function> est similaire à - <function>fbsql_fetch_array</function>, à la différence qu'elle - retourne un objet. Nous ne pouvez alors accéder aux données qu'avec - les noms des colonnes, et sous la forme de membres d'objet, et non - plus avec leurs index (les nombres ne peuvent représenter un membre - d'objet). - </para> - <para> - En terme de vitesse, cette fonction est identique à - <function>fbsql_fetch_array</function> et presque aussi rapide que - <function>fbsql_fetch_row</function> (la différence n'est pas - significative). - <example> - <title>Exemple avec <function>fbsql_fetch_object</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-fetch-object"> + <refnamediv> + <refname>fbsql_fetch_object</refname> + <refpurpose>Lit une ligne de résultat sous forme d'objet</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>object</type><methodname>fbsql_fetch_object</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_fetch_object</function> est similaire à + <function>fbsql_fetch_array</function>, à la différence qu'elle + retourne un objet. Nous ne pouvez alors accéder aux données qu'avec + les noms des colonnes, et sous la forme de membres d'objet, et non + plus avec leurs index (les nombres ne peuvent représenter un membre + d'objet). + </para> + <para> + En terme de vitesse, cette fonction est identique à + <function>fbsql_fetch_array</function> et presque aussi rapide que + <function>fbsql_fetch_row</function> (la différence n'est pas + significative). + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un objet dont les propriétés correspondent à la ligne récupérée ou + &false; s'il n'y a plus de ligne à lire. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_fetch_object</function></title> + <programlisting role="php"> <![CDATA[ <?php fbsql_connect($host, $user, $password); -$result = fbsql_db_query("database", "select * from table;"); +$result = fbsql_db_query("database", "select * from table"); while ($row = fbsql_fetch_object($result)) { - echo $row->user_id; - echo $row->fullname; + echo $row->user_id; + echo $row->fullname; } - fbsql_free_result($result); +fbsql_free_result($result); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>fbsql_fetch_array</function> et - <function>fbsql_fetch_row</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_fetch_array</function></member> + <member><function>fbsql_fetch_row</function></member> + <member><function>fbsql_fetch_assoc</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -77,4 +102,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-fetch-row.xml Tue Jan 23 19:04:36 2007 @@ -1,44 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-fetch-row"> - <refnamediv> - <refname>fbsql_fetch_row</refname> - <refpurpose>Lit une ligne de résultat sous forme de tableau numérique</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>fbsql_fetch_row</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_fetch_row</function> retourne un tableau représentant la ligne - courante dans le résultat <parameter>result</parameter>, ou - &false; s'il n'y a plus de ligne à lire. - </para> - <para> - <function>fbsql_fetch_row</function> lit une ligne de données dans le - résultat <parameter>result</parameter> et crée un tableau - indexé. Chaque colonne est stockée dans une case du tableau, dans le - même ordre que dans le résultat. Les indices commencent à 0. - </para> - <para> - Le prochain appel à <function>fbsql_fetch_row</function> va lire - la prochaine ligne, ou bien retourner &false; s'il n'y a plus - de ligne à lire. - </para> - <para> - Voir aussi - <function>fbsql_fetch_array</function>, - <function>fbsql_fetch_object</function>, - <function>fbsql_data_seek</function>, - <function>fbsql_fetch_lengths</function> et - <function>fbsql_result</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-fetch-row"> + <refnamediv> + <refname>fbsql_fetch_row</refname> + <refpurpose>Lit une ligne de résultat sous forme de tableau numérique</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>fbsql_fetch_row</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_fetch_row</function> lit une ligne de données dans le + résultat <parameter>result</parameter> et crée un tableau + indexé. + </para> + <para> + Le prochain appel à <function>fbsql_fetch_row</function> va lire + la prochaine ligne, ou bien retourner &false; s'il n'y a plus + de ligne à lire. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau qui correspond à la ligne récupérée où chaque colonne du + résultat y est stocké, en commançant par la position 0 ou &false; s'il n'y a plus + de ligne à lire. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_fetch_array</function></member> + <member><function>fbsql_fetch_assoc</function></member> + <member><function>fbsql_fetch_object</function></member> + <member><function>fbsql_data_seek</function></member> + <member><function>fbsql_fetch_lengths</function></member> + <member><function>fbsql_result</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -59,4 +80,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-flags.xml Tue Jan 23 19:04:36 2007 @@ -1,31 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-flags"> - <refnamediv> - <refname>fbsql_field_flags</refname> - <refpurpose> - Lit les options associées à une colonne de résultat - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_field_flags</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_flags</function> retourne les options du - champ <parameter>field_offset</parameter>, dans le résultat - <parameter>result</parameter>. Les options sont retournées - sous la forme d'un seul mot par option, séparées par des espaces, - de façon à faciliter la manipulation avec - <function>explode</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-field-flags"> + <refnamediv> + <refname>fbsql_field_flags</refname> + <refpurpose>Lit les options associées à une colonne de résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_field_flags</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + Lit les options associées à la colonne de résultat spécifié dans le résultat. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result</parameter></term> + <listitem> + <para> + Un pointeur de résultat, retourné par la fonction + <function>fbsql_list_fields</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne les options du champ <parameter>field_offset</parameter>, + dans le résultat <parameter>result</parameter>. Les options sont + retournées sous la forme d'un seul mot par option, séparées par des + espaces, de façon à faciliter la manipulation avec <function>explode</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-len.xml Tue Jan 23 19:04:36 2007 @@ -1,28 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-len"> - <refnamediv> - <refname>fbsql_field_len</refname> - <refpurpose> - Retourne la taille d'un champ - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_field_len</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_len</function> retourne la taille - du champ <parameter>field_offset</parameter> dans le résultat - <parameter>result</parameter>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-field-len"> + <refnamediv> + <refname>fbsql_field_len</refname> + <refpurpose>Retourne la taille d'un champs</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_field_len</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + Retourne la taille du champs spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result</parameter></term> + <listitem> + <para> + Un pointeur de résultat, retourné par la fonction + <function>fbsql_list_fields</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la taille du champs spécifié. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -43,4 +73,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml:1.13 phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml:1.14 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml:1.13 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-name.xml Tue Jan 23 19:04:36 2007 @@ -1,46 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: read --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: read --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-name"> - <refnamediv> - <refname>fbsql_field_name</refname> - <refpurpose>Lit le nom d'un champ</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_field_name</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_index</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_name</function> retourne le nom du champ - numéro <parameter>field_index</parameter> dans le résultat - <parameter>result</parameter>. <parameter>field_index</parameter> - est le résultat de <function>fbsql_query</function> et - <parameter>field_index</parameter> est l'index numérique du - champ. - </para> - <note> - <para> - <parameter>field_index</parameter> commence à 0. - </para> - <para> - e.g. L'index du troisème champ est 2, et l'index du quatrième - champ est 3... - </para> - </note> + +<refentry id="function.fbsql-field-name"> + <refnamediv> + <refname>fbsql_field_name</refname> + <refpurpose>Lit le nom d'un champs</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_field_name</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_index</parameter></methodparam> + </methodsynopsis> + <para> + Lit le nom d'un champs à un index spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result</parameter></term> + <listitem> + <para> + Un pointeur de résultat, retourné par la fonction + <function>fbsql_list_fields</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>field_index</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom sous la forme d'une &string; ou &false; si le + champs n'existe pas. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_field_name</function></title> <programlisting role="php"> <![CDATA[ <?php -// La table utilisateur est constituée de trois colonnes +// La table utilisateur est constituée de trois colonnes : // user_id // username // password -$res = fbsql_db_query("users", "select * from users;", $link); + +$res = fbsql_db_query("users", "select * from users", $link); + echo fbsql_field_name($res, 0) . "\n"; echo fbsql_field_name($res, 2); ?> @@ -52,9 +80,20 @@ user_id password ]]> - </screen> - </example> + </screen> + </example> + </para> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_field_type</function></member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file @@ -76,4 +115,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-seek.xml Tue Jan 23 19:04:36 2007 @@ -1,33 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-seek"> - <refnamediv> - <refname>fbsql_field_seek</refname> - <refpurpose> - Déplace le pointeur de résultat - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_field_seek</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_seek</function> place le pointeur de colonne - à la colonne <parameter>field_offset</parameter>. Si ce paramètre - est omis, <function>fbsql_fetch_field</function> retourne le - numéro de la colonne courante. - </para> - <para> - Voir aussi - <function>fbsql_fetch_field</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-field-seek"> + <refnamediv> + <refname>fbsql_field_seek</refname> + <refpurpose>Déplace le pointeur de résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_field_seek</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + Place le pointeur de colonne à la colonne spécifiée. + Si le prochain appel à <function>fbsql_fetch_field</function> + n'inclue pas un pointeur de champs, le pointeur du champs + spécifié dans <function>fbsql_field_seek</function> sera retourné. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_fetch_field</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -48,4 +77,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-table.xml Tue Jan 23 19:04:36 2007 @@ -1,28 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-table"> - <refnamediv> - <refname>fbsql_field_table</refname> - <refpurpose> - Lit le nom de la table d'origine d'un champ - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_field_table</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_table</function> retourne le nom de la - table d'où est issu le champ d'indice <parameter>field_offset</parameter>. - Les numéros de colonnes commencent à 0. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-field-table"> + <refnamediv> + <refname>fbsql_field_table</refname> + <refpurpose>Lit le nom de la table d'origine d'un champs</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_field_table</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le nom de la table d'où est issu le champs spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de la table, sous la forme d'une &string;. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -43,4 +65,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-field-type.xml Tue Jan 23 19:04:36 2007 @@ -1,58 +1,102 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-field-type"> - <refnamediv> - <refname>fbsql_field_type</refname> - <refpurpose> - Lit le type d'une colonne - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_field_type</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_field_type</function> est similaire à la fonction - <function>fbsql_field_name</function>. Les arguments sont - identiques, mais le type du champ est retourné. Il peut - valoir "int", "real", "string", "blob" ou d'autres valeurs, - comme décrit dans <ulink url="&url.fbsql.docs;">la documentation - FrontBase</ulink>. - <example> - <title>Exemple avec <function>fbsql_field_type</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-field-type"> + <refnamediv> + <refname>fbsql_field_type</refname> + <refpurpose>Lit le type d'une colonne</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_field_type</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_field_type</function> est similaire à la fonction + <function>fbsql_field_name</function>. Les arguments sont + identiques, mais le type du champ est retourné. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>field_offset</parameter></term> + <listitem> + <para> + La position numérique du champs. L'index des champs commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le type du champs, sous la forme d'une &string;. + </para> + <para> + Ce type peut être un parmis <literal>int</literal>, <literal>real</literal>, + <literal>string</literal>, <literal>blob</literal>, et d'autres, tel que spécifié + dans la <ulink url="&url.fbsql.docs;">documentation de FrontBase</ulink>. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_field_type</function></title> + <programlisting role="php"> <![CDATA[ <?php -fbsql_connect("localhost:3306"); + fbsql_connect("localhost", "_SYSTEM", ""); +fbsql_select_db("wisconsin"); $result = fbsql_query("SELECT * FROM onek;"); $fields = fbsql_num_fields($result); $rows = fbsql_num_rows($result); $i = 0; $table = fbsql_field_table($result, $i); echo "Votre table '" . $table . "' a " . $fields . " colonnes et " . $rows . " lignes <br />"; -echo 'La table dispose des champs suivants <br />'; +echo "TLa table dispose des champs suivants <br />"; while ($i < $fields) { - $type = fbsql_field_type ($result, $i); - $name = fbsql_field_name ($result, $i); - $len = fbsql_field_len ($result, $i); - $flags = fbsql_field_flags($result, $i); - echo $type . ' ' . $name . ' ' . $len . ' ' . $flags . '<br />'; - $i++; + $type = fbsql_field_type($result, $i); + $name = fbsql_field_name($result, $i); + $len = fbsql_field_len($result, $i); + $flags = fbsql_field_flags($result, $i); + echo $type . " " . $name . " " . $len . " " . $flags . "<br />"; + $i++; } fbsql_close(); + ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_field_name</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -73,4 +117,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-free-result.xml Tue Jan 23 19:04:36 2007 @@ -1,31 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-free-result"> - <refnamediv> - <refname>fbsql_free_result</refname> - <refpurpose>Libère le résultat de la mémoire</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_free_result</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_free_result</function> va libérer toute la mémoire - utilisée par le résultat associé à la ressource <parameter>result</parameter>. - </para> - <para> - <function>fbsql_free_result</function> n'a besoin d'être appelé que si vous - craignez que votre script ne consomme trop de mémoire, lorsqu'une - requête retourne de très grands résultats. Toutes les ressources - mémoire utilisées par le script sont de toute manière libérées à - la fin du script. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-free-result"> + <refnamediv> + <refname>fbsql_free_result</refname> + <refpurpose>Libère le résultat de la mémoire</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_free_result</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + Libérer toute la mémoire utilisée par le résultat associé à la ressource <parameter>result</parameter>. + </para> + <para> + <function>fbsql_free_result</function> n'a besoin d'être appelé que si vous + craignez que votre script ne consomme trop de mémoire, lorsqu'une + requête retourne de très grands résultats. Toutes les ressources + mémoire utilisées par le script sont de toute manière libérées à + la fin du script. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +63,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml:1.5 phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml:1.6 --- phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml:1.5 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-get-autostart-info.xml Tue Jan 23 19:04:36 2007 @@ -1,23 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-get-autostart-info"> - <refnamediv> - <refname>fbsql_get_autostart_info</refname> - <refpurpose>Pas de documentation</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>fbsql_get_autostart_info</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-get-autostart-info'> + <refnamediv> + <refname>fbsql_get_autostart_info</refname> + <refpurpose></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>fbsql_get_autostart_info</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -38,4 +48,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml:1.6 phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml:1.7 --- phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml:1.6 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-hostname.xml Tue Jan 23 19:04:36 2007 @@ -1,24 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id='function.fbsql-hostname'> - <refnamediv> - <refname>fbsql_hostname</refname> - <refpurpose>Lit ou définit le nom de l'hôte à utiliser avec une connexion</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_hostname</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>host_name</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-hostname'> + <refnamediv> + <refname>fbsql_hostname</refname> + <refpurpose>Lit ou définit le nom de l'hôte à utiliser avec une connexion</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_hostname</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>host_name</parameter></methodparam> + </methodsynopsis> + <para> + Lit ou définit le nom de l'hôte à utiliser avec une connexion. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>host_name</parameter></term> + <listitem> + <para> + Si fourni, ce sera le nouveau nom de l'hôte à utiliser. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de l'hôte courant pour la connexion. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_username</function></member> + <member><function>fbsql_password</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -39,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-insert-id.xml Tue Jan 23 19:04:36 2007 @@ -1,45 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-insert-id"> - <refnamediv> - <refname>fbsql_insert_id</refname> - <refpurpose> - Lit le dernier identifiant généré par une requête INSERT - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_insert_id</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_insert_id</function> retourne l'identifiant généré - par la colonne de type DEFAULT UNIQUE, lors de la dernière requête - INSERT, avec la connexion <parameter>link_identifier</parameter>. - Si <parameter>link_identifier</parameter> est omis, la dernière connexion - ouverte est utilisée. - </para> + +<refentry id="function.fbsql-insert-id"> + <refnamediv> + <refname>fbsql_insert_id</refname> + <refpurpose>Lit le dernier identifiant généré par une requête INSERT</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_insert_id</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne l'identifiant généré par la colonne de type DEFAULT UNIQUE, lors + de la dernière requête INSERT. + </para> + <note> <para> - <function>fbsql_insert_id</function> retournera 0 si la dernière - requête n'a pas généré de valeur dans la - colonne DEFAULT UNIQUE. - Si vous devez sauver cette valeur pour plus tard, n'oubliez pas - d'appeler <function>fbsql_insert_id</function> tout de suite - après la requête qui a généré cette valeur. + La valeur de la fonction FrontBase SQL + <function>fbsql_insert_id</function> retourne toujours la dernière + valeur générée par DEFAULT UNIQUE et n'est jamais annulée entre les + requêtes. </para> - <note> - <para> - La valeur de la fonction FrontBase SQL - "<literal>LAST_INSERT_ID()</literal>" retourne toujours la dernière - valeur générée par DEFAULT UNIQUE et n'est jamais annulée entre les - requêtes. - </para> - </note> - </refsect1> - </refentry> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne l'identifiant généré depuis la dernière requête INSERT, ou &zero; + si la dernière requête n'a pas générée une valeur DEFAULT UNIQUE. + </para> + <para> + Si vous devez sauver cette valeur pour plus tard, n'oubliez pas + d'appeler <function>fbsql_insert_id</function> tout de suite + après la requête qui a généré cette valeur. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_affected_rows</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -60,4 +81,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml:1.11 phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml:1.12 --- phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml:1.11 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-list-dbs.xml Tue Jan 23 19:04:36 2007 @@ -1,60 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-list-dbs"> - <refnamediv> - <refname>fbsql_list_dbs</refname> - <refpurpose> - Liste les bases de données FBSQL - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_list_dbs</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_list_dbs</function> retourne un résultat contenant la - liste des bases de données disponibles sur le serveur - <optional>link_identifier</optional>. Utilisez la fonction - <function>fbsql_tablename</function> pour passer en revue ce - résultat. - </para> - <para> - <example> - <title>Exemple avec <function>fbsql_list_dbs</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-list-dbs"> + <refnamediv> + <refname>fbsql_list_dbs</refname> + <refpurpose>Liste les bases de données FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_list_dbs</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne un résultat contenant la liste des bases de données + disponibles sur le serveur <optional>link_identifier</optional>. + Utilisez la fonction <function>fbsql_tablename</function> pour + passer en revue ce résultat. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un pointeur de résultat ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_list_dbs</function></title> + <programlisting role="php"> <![CDATA[ -<?php $link = fbsql_connect('localhost', 'myname', 'secret'); $db_list = fbsql_list_dbs($link); + while ($row = fbsql_fetch_object($db_list)) { - echo $row->Database . "\n"; + echo $row->Database . "\n"; } -?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ database1 database2 database3 ... ]]> - </screen> - </example> + </screen> + </example> + </para> + <note> + <para> + L'exemple ci-dessus peut aussi bien fonctionner avec la fonction + <function>fbsql_fetch_row</function> ou toute autre similaire. </para> - <note> - <para> - L'exemple ci-dessus peut aussi bien fonctionner avec la fonction - <function>fbsql_fetch_row</function> ou toute autre similaire. - </para> - </note> - </refsect1> - </refentry> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_list_fields</function></member> + <member><function>fbsql_list_tables</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -75,4 +104,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml:1.12 phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml:1.13 --- phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml:1.12 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-list-fields.xml Tue Jan 23 19:04:36 2007 @@ -1,67 +1,114 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-list-fields"> - <refnamediv> - <refname>fbsql_list_fields</refname> - <refpurpose>Liste les champs d'un résultat FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_list_fields</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam><type>string</type><parameter>table_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_list_fields</function> lit les informations à propos - de la table <parameter>table_name</parameter>, dans la base de données - <parameter>table_name</parameter>, sur la connexion - <parameter>link_identifier</parameter>. Un résultat de requête est - retourné, et pourra être utilisé avec les fonctions - <function>fbsql_field_flags</function>, - <function>fbsql_field_len</function>, - <function>fbsql_field_name</function> et - <function>fbsql_field_type</function>. - </para> - <para> - Un identifiant de résultat est une ressource &php;, représentée par - un entier positif. <function>fbsql_list_fields</function> retourne - -1 en cas d'erreur. Une chaîne décrivant l'erreur sera alors placée dans - la variable <literal>$phperrmsg</literal>. Un message d'erreur sera - aussi affiché, à moins que la fonction n'ait été appelée avec l'opérateur - de suppression des erreurs @. - </para> - <para> - <example> - <title>Exemple avec <function>fbsql_list_fields</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-list-fields"> + <refnamediv> + <refname>fbsql_list_fields</refname> + <refpurpose>Liste les champs d'une table FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_list_fields</methodname> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam><type>string</type><parameter>table_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Liste les champs d'une table fournie. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database_name</parameter></term> + <listitem> + <para> + Le nom de la base de données. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>table_name</parameter></term> + <listitem> + <para> + Le nom de la table. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un pointeur de résultat qui pourra être utilisé avec les fonctions + <literal>fbsql_field_xxx</literal> ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + Une chaîne décrivant l'erreur sera placée dans la variable + <literal>$phperrmsg</literal>, et ce, même si la fonction a été appelé comme ceci : + <literal>@fbsql()</literal>, puis, l'erreur sera également affichée. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_list_fields</function></title> + <programlisting role="php"> <![CDATA[ <?php -$link = fbsql_connect('localhost', 'monnom', 'secret'); +$link = fbsql_connect('localhost', 'myname', 'secret'); + $fields = fbsql_list_fields("database1", "table1", $link); $columns = fbsql_num_fields($fields); + for ($i = 0; $i < $columns; $i++) { - echo fbsql_field_name($fields, $i) . "\n";; + echo fbsql_field_name($fields, $i) . "\n";; } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ field1 field2 field3 ... ]]> - </screen> - </example> - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_field_len</function></member> + <member><function>fbsql_field_name</function></member> + <member><function>fbsql_field_type</function></member> + <member><function>fbsql_field_flags</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -82,4 +129,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml:1.8 phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml:1.9 --- phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml:1.8 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-list-tables.xml Tue Jan 23 19:04:36 2007 @@ -1,28 +1,64 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-list-tables"> - <refnamediv> - <refname>fbsql_list_tables</refname> - <refpurpose>Liste les tables dans une base de données FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_list_tables</methodname> - <methodparam><type>string</type><parameter>database</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_list_tables</function> liste les tables dans la base - de données <parameter>database</parameter>, et retourne un résultat, - tout comme <function>fbsql_db_query</function>. - <function>fbsql_tablename</function> sert à extraire la liste des tables - dans ce résultat. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-list-tables"> + <refnamediv> + <refname>fbsql_list_tables</refname> + <refpurpose>Liste les tables dans une base de données FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_list_tables</methodname> + <methodparam><type>string</type><parameter>database</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne un pointeur de résultat décrivant la base de données + <parameter>database</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database</parameter></term> + <listitem> + <para> + Le nom de la base de données. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un pointeur de résultat qui pourra être utilisé avec la fonction + <function>fbsql_tablename</function> pour lire les noms + des tables ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_list_fields</function></member> + <member><function>fbsql_list_dbs</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -43,4 +79,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml:1.11 phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml:1.12 --- phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml:1.11 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-next-result.xml Tue Jan 23 19:04:36 2007 @@ -1,32 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-next-result"> - <refnamediv> - <refname>fbsql_next_result</refname> - <refpurpose>Déplace le pointeur interne vers le résultat suivant</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_next_result</methodname> - <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> - </methodsynopsis> - <para> - Lorsque vous envoyez plus d'une commande SQL au serveur ou que vous - exécutez une procédure stockée avec de multiples résultats, cela va - conduire le serveur à retourner plusieurs jeux de lignes. - <function>fbsql_next_result</function> va vérifier l'existence de - plusieurs résultats disponibles sur le serveur. Si un autre - jeu de résultats existe, <function>fbsql_next_result</function> va - détruire le résultat précédent et préparer la lecture dans les - nouvelles lignes. - </para> - <para> - <function>fbsql_next_result</function> retourne &true; si - un autre résultat est disponible, ou &false; sinon. - </para> + +<refentry id="function.fbsql-next-result"> + <refnamediv> + <refname>fbsql_next_result</refname> + <refpurpose>Déplace le pointeur interne vers le résultat suivant</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_next_result</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + Lorsque vous envoyez plus d'une commande SQL au serveur ou que vous + exécutez une procédure stockée avec de multiples résultats, cela va + conduire le serveur à retourner plusieurs jeux de lignes. + <function>fbsql_next_result</function> va vérifier l'existence de + plusieurs résultats disponibles sur le serveur. Si un autre + jeu de résultats existe, <function>fbsql_next_result</function> va + détruire le résultat précédent et préparer la lecture dans les + nouvelles lignes. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si un jeu de résultats additionnel est disponible, + &false; sinon. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_next_result</function></title> <programlisting role="php"> @@ -37,17 +57,19 @@ $SQL = "Select * from table1; select * from table2;"; $rs = fbsql_query($SQL, $link); do { - while ($row = fbsql_fetch_row($rs)) {} + while ($row = fbsql_fetch_row($rs)) { + } } while (fbsql_next_result($rs)); - fbsql_free_result($rs); fbsql_close($link); ?> ]]> </programlisting> </example> - </refsect1> - </refentry> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -68,4 +90,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml:1.7 phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml:1.8 --- phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml:1.7 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-num-fields.xml Tue Jan 23 19:04:36 2007 @@ -1,31 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-num-fields"> - <refnamediv> - <refname>fbsql_num_fields</refname> - <refpurpose>Lit le nombre de champs dans un résultat</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_num_fields</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_num_fields</function> retourne le nombre de champs - dans le résultat <parameter>result</parameter>. - </para> - <para> - Voir aussi - <function>fbsql_db_query</function>, - <function>fbsql_query</function>, - <function>fbsql_fetch_field</function> et - <function>fbsql_num_rows</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-num-fields"> + <refnamediv> + <refname>fbsql_num_fields</refname> + <refpurpose>Lit le nombre de champs dans un résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_num_fields</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le nombre de champs dans le résultat <parameter>result</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nombre de champs, sous la forme d'un &integer;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_db_query</function></member> + <member><function>fbsql_query</function></member> + <member><function>fbsql_fetch_field</function></member> + <member><function>fbsql_num_rows</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +69,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-num-rows.xml Tue Jan 23 19:04:36 2007 @@ -1,50 +1,83 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-num-rows"> - <refnamediv> - <refname>fbsql_num_rows</refname> - <refpurpose>Lit le nombre de lignes dans un résultat</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_num_rows</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_num_rows</function> retourne le nombre de lignes - dans le résultat <parameter>result</parameter>. Cette fonction - n'est valable qu'avec les commandes SELECT. Pour connaître le nombre - de lignes dans une requête INSERT, UPDATE ou DELETE, utilisez - <function>fbsql_affected_rows</function>. - <example> - <title>Exemple <function>fbsql_num_rows</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-num-rows"> + <refnamediv> + <refname>fbsql_num_rows</refname> + <refpurpose>Lit le nombre de lignes dans un résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_num_rows</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + Lit le nombre de lignes dans le jeu de résultats <parameter>result</parameter>. + </para> + <para> + Cette fonction n'est valable qu'avec les commandes SELECT. Pour connaître le nombre + de lignes dans une requête INSERT, UPDATE ou DELETE, utilisez + <function>fbsql_affected_rows</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nombre de lignes retourné par la dernière requête SELECT. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_num_rows</function></title> + <programlisting role="php"> <![CDATA[ <?php -$link = fbsql_connect('localhost', 'utilisateur', 'password'); + +$link = fbsql_connect("localhost", "username", "password"); fbsql_select_db("database", $link); $result = fbsql_query("SELECT * FROM table1;", $link); $num_rows = fbsql_num_rows($result); echo "$num_rows lignes\n"; + ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>fbsql_affected_rows</function>, - <function>fbsql_connect</function>, - <function>fbsql_select_db</function> et - <function>fbsql_query</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_affected_rows</function></member> + <member><function>fbsql_connect</function></member> + <member><function>fbsql_select_db</function></member> + <member><function>fbsql_query</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -65,4 +98,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-password.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-password.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-password.xml:1.6 phpdoc-fr/reference/fbsql/functions/fbsql-password.xml:1.7 --- phpdoc-fr/reference/fbsql/functions/fbsql-password.xml:1.6 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-password.xml Tue Jan 23 19:04:36 2007 @@ -1,24 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-password"> - <refnamediv> - <refname>fbsql_password</refname> - <refpurpose>Lit ou définit le mot de passe à utiliser avec une connexion</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_password</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-password'> + <refnamediv> + <refname>fbsql_password</refname> + <refpurpose>Lit ou définit le mot de passe à utiliser avec une connexion</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_password</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> + </methodsynopsis> + <para> + Lit ou définit le mot de passe à utiliser avec une connexion. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Si fourni, il sera le nouveau mot de passe pour la connexion. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le mot de passe courant pour la connexion. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_username</function></member> + <member><function>fbsql_hostname</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -39,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-pconnect.xml Tue Jan 23 19:04:36 2007 @@ -1,61 +1,102 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-pconnect"> - <refnamediv> - <refname>fbsql_pconnect</refname> - <refpurpose> - Ouvre une connexion persistante à un serveur FrontBase - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_pconnect</methodname> - <methodparam choice="opt"><type>string</type><parameter>hostname</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_pconnect</function> retourne une ressource représentant - la connexion au serveur FrontBase en cas de succès, ou bien - &false; en cas d'erreur. - </para> - <para> - <function>fbsql_pconnect</function> établit une connexion - persistante à un serveur FrontBase. En cas d'omission, les valeurs - suivantes sont utilisées par défaut : - <parameter>host</parameter> ='localhost', - <parameter>username</parameter> = nom de l'utilisateur qui possède - le processus, et <parameter>password</parameter> = pas de mot de passe. - </para> - <para> - Pour choisir le port d'accès au serveur FrontBase, voyez - <function>fbsql_select_db</function>. - </para> - <para> - <function>fbsql_pconnect</function> se comporte comme - <function>fbsql_connect</function> avec deux différences majeures. - </para> - <para> - Premièrement, lors de la connexion, <function>fbsql_pconnect</function> - essaie de trouver une connexion permanante déjà ouverte sur - cet hôte, avec les mêmes nom d'utilisateur et mot de passe. Si une - telle connexion est trouvée, son identifiant est retourné - sans ouvrir de nouvelle connexion. - </para> - <para> - Deuxièmement, la connexion au serveur fbssl ne sera pas terminée avec la fin - du script. Au lieu de cela, le lien sera conservé pour un prochain accès - (<function>fbsql_close</function> ne terminera pas une connexion persistante - établie par <function>fbsql_pconnect</function>). - </para> - <para> - C'est pourquoi ce type de connexion est dit 'persistant'. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-pconnect"> + <refnamediv> + <refname>fbsql_pconnect</refname> + <refpurpose>Ouvre une connexion persistante sur un serveur FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_pconnect</methodname> + <methodparam choice="opt"><type>string</type><parameter>hostname</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> + </methodsynopsis> + <para> + Ouvre une connexion persistante sur un serveur FrontBase. + </para> + <para> + Pour choisir le port d'accès au serveur FrontBase, voyez + <function>fbsql_select_db</function>. + </para> + <para> + <function>fbsql_pconnect</function> se comporte comme + <function>fbsql_connect</function> avec deux différences majeures : + </para> + <para> + Premièrement, lors de la connexion, <function>fbsql_pconnect</function> + essaie de trouver une connexion permanante déjà ouverte sur + cet hôte, avec les mêmes nom d'utilisateur et mot de passe. Si une + telle connexion est trouvée, son identifiant est retourné + sans ouvrir de nouvelle connexion. + </para> + <para> + Deuxièmement, la connexion au serveur fbssl ne sera pas terminée avec la fin + du script. Au lieu de cela, le lien sera conservé pour un prochain accès + (<function>fbsql_close</function> ne terminera pas une connexion persistante + établie par <function>fbsql_pconnect</function>). + </para> + <para> + C'est pourquoi ce type de connexion est dit 'persistant'. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hostname</parameter></term> + <listitem> + <para> + Le nom de l'hôte du serveur. Par défaut, c'est <literal>localhost</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>username</parameter></term> + <listitem> + <para> + Le nom d'utilisateur pour la connexion. Par défaut, c'est + <literal>_SYSTEM</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Le mot de passe pour la connexion. Par défaut, c'est une chaîne vide. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un identifiant de connexion persistant FrontBase en cas de succès, + ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_connect</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -76,4 +117,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-query.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-query.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-query.xml:1.13 phpdoc-fr/reference/fbsql/functions/fbsql-query.xml:1.14 --- phpdoc-fr/reference/fbsql/functions/fbsql-query.xml:1.13 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-query.xml Tue Jan 23 19:04:36 2007 @@ -1,105 +1,137 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-query"> - <refnamediv> - <refname>fbsql_query</refname> - <refpurpose>Exécute une requête sur un serveur FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_query</methodname> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>batch_size</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_query</function> envoie la requête - <parameter>query</parameter> à la base de données courante, - sur le serveur représenté par sa connexion <parameter>link_identifier</parameter>. - Si <parameter>link_identifier</parameter> est omis, la dernière - connexion ouverte est utilisée. Si aucune connexion n'a été ouverte, - <function>fbsql_query</function> essaie d'établir une connexion en - appelant la fonction <function>fbsql_connect</function> sans - aucun argument. - </para> - <note> - <para> - La requête doit être terminée par un point-virgule ! - </para> - </note> - <para> - <function>fbsql_query</function> retourne une ressource - en cas de succès, ou &false;, en cas - d'échec. Si &true; est retourné, cela signifie que la requête est correct et qu'elle - peut être exécutée par le serveur. Cela n'indique rien sur le nombre de lignes - concernées ou retournées. Il est tout à fait possible qu'une requête réussisse mais - qu'aucune ligne ne soit affectée ni retournée. - </para> + +<refentry id="function.fbsql-query"> + <refnamediv> + <refname>fbsql_query</refname> + <refpurpose>Exécute une requête sur un serveur FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_query</methodname> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>batch_size</parameter></methodparam> + </methodsynopsis> + <para> + Envoie la requête <parameter>query</parameter> à la base de données + courante, sur le serveur. + </para> + <para> + Lorsque la requête réussit, vous pouvez utilisez + <function>fbsql_num_rows</function> pour savoir combien de + lignes ont été retournées par une requête SELECT, ou + <function>fbsql_affected_rows</function> pour les autres + requêtes (DELETE, INSERT, REPLACE et UPDATE). + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>query</parameter></term> + <listitem> + <para> + La requête SQL à exécuter. + </para> + <note> + <para> + La requête doit toujours se terminer par un point virgule. + </para> + </note> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>batch_size</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <function>fbsql_query</function> retourne une ressource + en cas de succès, ou &false;, en cas d'échec. Si &true; est + retourné, cela signifie que la requête est correct et qu'elle peut + être exécutée par le serveur. Cela n'indique rien sur le nombre + de lignes concernées ou retournées. Il est tout à fait possible + qu'une requête réussisse mais qu'aucune ligne ne soit affectée + ni retournée. + </para> + <para> + Pour les requêtes SELECT, <function>fbsql_query</function> retourne + une ressource de résultat, que vous pouvez passer à + <function>fbsql_result</function>. + </para> + <para> + <function>fbsql_query</function> échouera si vous n'avez pas + les droits d'accès sur l'une des bases de données utilisées dans + la requête. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> - La requête suivante est invalide, et <function>fbsql_query</function> - échouera puis retournera &false;: - <example> - <title>Exemple avec <function>fbsql_query</function>(1)</title> - <programlisting role="php"> + La requête suivante est invalide, et <function>fbsql_query</function> + échouera puis retournera &false; : + <example> + <title>Exemple avec <function>fbsql_query</function></title> + <programlisting role="php"> <![CDATA[ <?php -$result = fbsql_query("SELECT * WHERE 1=1;") - or die("Requête invalide"); +$result = fbsql_query("SELECT * WHERE 1=1") + or die ("Requête invalide"); ?> ]]> - </programlisting> - </example> - </para> - <para> - La requête suivante est invalide si <literal>my_col</literal> n'est pas - une colonne dans la table <literal>my_tbl</literal> : <function>fbsql_query</function> - échouera puis retournera &false; : - <example> - <title>Exemple avec <function>fbsql_query</function>(2)</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + La requête suivante est invalide si <literal>my_col</literal> n'est pas + une colonne dans la table <literal>my_tbl</literal> : <function>fbsql_query</function> + échouera puis retournera &false; : + <example> + <title>Exemple avec <function>fbsql_query</function></title> + <programlisting role="php"> <![CDATA[ <?php -$result = fbsql_query("SELECT my_col FROM my_tbl") +$result = fbsql_query ("SELECT my_col FROM my_tbl;") or die ("Requête invalide"); ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>fbsql_query</function> échouera si vous n'avez pas - les droits d'accès sur l'une des bases de données utilisées dans - la requête. - </para> - <para> - Lorsque la requête réussit, vous pouvez utilisez - <function>fbsql_num_rows</function> pour savoir combien de - lignes ont été retournées par une requête SELECT, ou - <function>fbsql_affected_rows</function> pour les autres - requêtes (DELETE, INSERT, REPLACE et UPDATE). - </para> - <para> - Pour les requêtes SELECT, <function>fbsql_query</function> retourne - une ressource de résultat, que vous pouvez passer à <function>fbsql_result</function>. - Lorsque vous avez fini de lire le résultat, vous pouvez libérer les - ressources utilisées en appelant - <function>fbsql_free_result</function>. Cependant, la mémoire sera automatiquement - libérée à la fin du script. - </para> - <para> - Voir aussi - <function>fbsql_affected_rows</function>, - <function>fbsql_db_query</function>, - <function>fbsql_free_result</function>, - <function>fbsql_result</function>, - <function>fbsql_select_db</function> et - <function>fbsql_connect</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_affected_rows</function></member> + <member><function>fbsql_db_query</function></member> + <member><function>fbsql_free_result</function></member> + <member><function>fbsql_result</function></member> + <member><function>fbsql_select_db</function></member> + <member><function>fbsql_connect</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -120,4 +152,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml:1.12 phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml:1.13 --- phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml:1.12 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-read-blob.xml Tue Jan 23 19:04:36 2007 @@ -1,71 +1,104 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-read-blob"> - <refnamediv> - <refname>fbsql_read_blob</refname> - <refpurpose>Lit un BLOB dans une base de données</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_read_blob</methodname> - <methodparam><type>string</type><parameter>blob_handle</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_read_blob</function> retourne une chaîne de caractères - contenant le BLOB <parameter>blob_handle</parameter>. - </para> - <para> - <function>fbsql_read_blob</function> lit les données du BLOB dans - la base de données. Si une sélection contient une colonne - de type BLOB et/ou de type CLOB, FrontBase retournera directement les - données lors de la lecture. Ce comportement par défaut peut être - modifié avec la fonction <function>fbsql_set_lob_mode</function> pour que - les fonctions de lecture ne retournent qu'un identifiant de - BLOB ou CLOB. Si un identifiant est lu, il faut utiliser la fonction - <function>fbsql_read_blob</function> pour obtenir la valeur du BLOB. - </para> + +<refentry id="function.fbsql-read-blob"> + <refnamediv> + <refname>fbsql_read_blob</refname> + <refpurpose>Lit un BLOB dans une base de données</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_read_blob</methodname> + <methodparam><type>string</type><parameter>blob_handle</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Lit un BLOB d'une base de données. + </para> + <para> + Si une sélection contient une colonne de type BLOB et/ou de type + CLOB, FrontBase retournera directement les données lors de la + lecture. Ce comportement par défaut peut être modifié avec la + fonction <function>fbsql_set_lob_mode</function> pour que + les fonctions de lecture ne retournent qu'un identifiant de BLOB + ou CLOB. Si un identifiant est lu, il faut utiliser la fonction + <function>fbsql_read_blob</function> pour obtenir la valeur du BLOB. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>blob_handle</parameter></term> + <listitem> + <para> + Un gestionnaire BLOB, retourné par la fonction + <function>fbsql_create_blob</function>. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une &string; contenant les données du BLOB spécifié. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_read_blob</function></title> <programlisting role="php"> <![CDATA[ <?php - -$link = fbsql_pconnect ("localhost", "_SYSTEM", "secret") - or die ("Impossible de se connecter"); - +$link = fbsql_pconnect("localhost", "_SYSTEM", "secret") + or die("Impossible de se connecter"); $sql = "SELECT BLOB_COLUMN FROM BLOB_TABLE;"; $rs = fbsql_query($sql, $link); $row_data = fbsql_fetch_row($rs); - // $row_data[0] contiendra maintenant les données du blob de la première // ligne - fbsql_free_result($rs); + $rs = fbsql_query($sql, $link); fbsql_set_lob_mode($rs, FBSQL_LOB_HANDLE); $row_data = fbsql_fetch_row($rs); - -// $row_data[0] contiendra maintenant un identifiant vers les données du -// blob de la première ligne - +// $row_data[0] contient maintenant un gestionnaire vers les données BLOB +// dans la première ligne $blob_data = fbsql_read_blob($row_data[0]); fbsql_free_result($rs); + ?> ]]> </programlisting> </example> - <para> - Voir aussi - <function>fbsql_create_blob</function>, - <function>fbsql_read_clob</function> et - <function>fbsql_set_lob_mode</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_create_blob</function></member> + <member><function>fbsql_read_clob</function></member> + <member><function>fbsql_set_lob_mode</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml:1.12 phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml:1.13 --- phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml:1.12 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-read-clob.xml Tue Jan 23 19:04:36 2007 @@ -1,71 +1,104 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-read-clob"> - <refnamediv> - <refname>fbsql_read_clob</refname> - <refpurpose>Lit un CLOB dans une base de données</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_read_clob</methodname> - <methodparam><type>string</type><parameter>clob_handle</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_read_clob</function> retourne une chaîne de caractères - contenant le CLOB <parameter>clob_handle</parameter>. - </para> - <para> - <function>fbsql_read_clob</function> lit les données du CLOB dans - la base de données. Si une sélection contient une colonne - de type CLOB et/ou de type BLOB, FrontBase retournera directement les - données lors de la lecture. Ce comportement par défaut peut être - modifié avec la fonction <function>fbsql_set_lob_mode</function> pour que - les fonctions de lecture ne retournent qu'un identifiant de - BLOB ou CLOB. Si un identifiant est lu, il faut utiliser la fonction - <function>fbsql_read_clob</function> pour obtenir la valeur du CLOB. - </para> + +<refentry id="function.fbsql-read-clob"> + <refnamediv> + <refname>fbsql_read_clob</refname> + <refpurpose>Lit un CLOB dans une base de données</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_read_clob</methodname> + <methodparam><type>string</type><parameter>clob_handle</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Lit un CLOB d'une base de données. + </para> + <para> + Si une sélection contient une colonne de type CLOB et/ou de type + BLOB, FrontBase retournera directement les données lors de la + lecture. Ce comportement par défaut peut être modifié avec la + fonction <function>fbsql_set_lob_mode</function> pour que + les fonctions de lecture ne retournent qu'un identifiant de BLOB + ou CLOB. Si un identifiant est lu, il faut utiliser la fonction + <function>fbsql_read_clob</function> pour obtenir la valeur du CLOB. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>clob_handle</parameter></term> + <listitem> + <para> + Un gestionnaire CLOB, retourné par la fonction + <function>fbsql_create_clob</function>. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une &string; contenant les données du CLOB spécifié. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_read_clob</function></title> <programlisting role="php"> <![CDATA[ <?php - -$link = fbsql_pconnect ("localhost", "_SYSTEM", "secret") - or die ("Impossible de se connecter"); - +$link = fbsql_pconnect("localhost", "_SYSTEM", "secret") + or die("Impossible de se connecter"); $sql = "SELECT CLOB_COLUMN FROM CLOB_TABLE;"; $rs = fbsql_query($sql, $link); $row_data = fbsql_fetch_row($rs); - // $row_data[0] contiendra maintenant les données du blob de la // première ligne - fbsql_free_result($rs); + $rs = fbsql_query($sql, $link); fbsql_set_lob_mode($rs, FBSQL_LOB_HANDLE); $row_data = fbsql_fetch_row($rs); - // $row_data[0] contiendra maintenant un identifiant vers les // données du clob de la première ligne - $clob_data = fbsql_read_clob($row_data[0]); fbsql_free_result($rs); + ?> ]]> </programlisting> </example> - <para> - Voir aussi - <function>fbsql_create_blob</function>, - <function>fbsql_read_blob</function> et - <function>fbsql_set_lob_mode</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_create_clob</function></member> + <member><function>fbsql_read_blob</function></member> + <member><function>fbsql_set_lob_mode</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -86,4 +119,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-result.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-result.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-result.xml:1.11 phpdoc-fr/reference/fbsql/functions/fbsql-result.xml:1.12 --- phpdoc-fr/reference/fbsql/functions/fbsql-result.xml:1.11 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-result.xml Tue Jan 23 19:04:36 2007 @@ -1,49 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-result"> - <refnamediv> - <refname>fbsql_result</refname> - <refpurpose>Lit des données dans un résultat</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>fbsql_result</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>field</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_result</function> lit le contenu du champ - <parameter>field</parameter>, dans la ligne <parameter>row</parameter>, - du résultat <parameter>result</parameter>. L'argument - <parameter>field</parameter> peut être l'index du champ, ou bien - son nom, ou bien le nom de sa table plus point plus son nom. Si la - colonne a été aliasée, utilisez de préférence l'alias. - </para> - <para> - Lorsque vous travaillez sur de grands résultats, il est vivement - recommandé d'utiliser les fonctions qui lisent toute une ligne - d'un coup, plutôt que <function>fbsql_result</function> qui - travaille ligne par ligne. Elles sont beaucoup plus rapides. Notez aussi - que les offset numériques sont plus rapides que les offset - nominaux. - </para> - <para> - L'utilisation de <function>fbsql_result</function> ne doit pas - être mélangée avec d'autres fonctions qui utilisent aussi le résultat - <parameter>result</parameter>. - </para> - <para> - Alternatives vivement recommandées : - <function>fbsql_fetch_row</function>, - <function>fbsql_fetch_array</function> et - <function>fbsql_fetch_object</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-result"> + <refnamediv> + <refname>fbsql_result</refname> + <refpurpose>Lit des données dans un résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>fbsql_result</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>field</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le contenu d'une cellule depuis un jeu de résultat FrontBase. + </para> + <para> + Lorsque vous travaillez sur de grands résultats, il est vivement + recommandé d'utiliser les fonctions qui lisent toute une ligne + d'un coup, plutôt que <function>fbsql_result</function> qui + travaille ligne par ligne. Elles sont beaucoup plus rapides. Notez aussi + que les offset numériques sont plus rapides que les offset + nominaux. + </para> + <para> + L'utilisation de <function>fbsql_result</function> ne doit pas + être mélangée avec d'autres fonctions qui utilisent aussi le résultat + <parameter>result</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>row</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>field</parameter></term> + <listitem> + <para> + Peut être la position du champs ou le nom du champs, ou le + nom de la table, suivi d'un point, suivi du nom du champs + (tabledname.fieldname). + </para> + <para> + Si l'on n'utilise pas d'aliase ('select foo as bar from...'), + utilisez plutôt le nom de la colonne. + </para> + <note> + <para> + Le fait de spécifier une position numérique pour l'argument du champs + est plus rapide que de spécifier le nom du champs ou la forme + tablename.fieldname comme argument. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + Alternatives vivement recommandées : + <simplelist> + <member><function>fbsql_fetch_row</function></member> + <member><function>fbsql_fetch_array</function></member> + <member><function>fbsql_fetch_assoc</function></member> + <member><function>fbsql_fetch_object</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -64,4 +112,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-rollback.xml Tue Jan 23 19:04:36 2007 @@ -1,34 +1,57 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-rollback"> - <refnamediv> - <refname>fbsql_rollback</refname> - <refpurpose>Annule une transaction FBSQL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_rollback</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_rollback</function> termine la transaction - courante en annulant toutes les requêtes émises depuis la - dernière validation. Cette commande n'est utile que si FrontBase - est en mode de validation manuelle. - </para> - <para> - &return.success; - </para> - <para> - Voir aussi - <function>fbsql_autocommit</function> et - <function>fbsql_commit</function> - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-rollback"> + <refnamediv> + <refname>fbsql_rollback</refname> + <refpurpose>Annule une transaction FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_rollback</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Termine la transaction courante en annulant toutes les requêtes + émises depuis la dernière validation. + </para> + <para> + Cette commande n'est utile que si FrontBase est en mode de + validation manuelle. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_autocommit</function></member> + <member><function>fbsql_commit</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -49,4 +72,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-select-db.xml Tue Jan 23 19:04:36 2007 @@ -1,57 +1,82 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-select-db"> - <refnamediv> - <refname>fbsql_select_db</refname> - <refpurpose>Sélectionne une base de données FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_select_db</methodname> - <methodparam choice="opt"><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_select_db</function> remplace la base de données - active courante par <parameter>database_name</parameter>, sur la - connexion ouverte et représentée par <parameter>link_identifier</parameter>. - Si <parameter>link_identifier</parameter> est omis, la dernière - connexion ouverte sera utilisée. Si aucune connexion n'a été ouverte, - <function>fbsql_select_db</function> essaiera de se connecter - en appelant <function>fbsql_connect</function> sans arguments. - </para> - <para> - &return.success; - </para> - <para> - Le client contacte FBExec pour connaître le numéro de port à utiliser - pour la connexion à la base de données. Si le nom de la base est un - numéro, le système l'utilisera comme numéro de port, et ne - le demandera pas à FBExec. Le serveur Frontbase peut être - démarré avec la commande : - <literal>FRontBase -FBExec=No -port=<port number> <database name></literal>. - </para> - <para> - Tous les prochains appels à <function>fbsql_query</function> se feront - dans la base <parameter>database_name</parameter>. - </para> - <para> - Si la base de données est protégée avec un mot de passe, l'utilisateur doit - appeler la fonction <function>fbsql_database_password</function> avant - de sélectionner la base de données. - </para> - <para> - Voir aussi - <function>fbsql_database_password</function>, - <function>fbsql_connect</function>, - <function>fbsql_pconnect</function> et - <function>fbsql_query</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-select-db"> + <refnamediv> + <refname>fbsql_select_db</refname> + <refpurpose>Sélectionne une base de données FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_select_db</methodname> + <methodparam choice="opt"><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Sélectionne une base de données FrontBase. + </para> + <para> + Le client contacte FBExec pour connaître le numéro de port à utiliser + pour la connexion à la base de données. Si le nom de la base est un + numéro, le système l'utilisera comme numéro de port, et ne + le demandera pas à FBExec. Le serveur Frontbase peut être + démarré avec la commande : + <literal>FRontBase -FBExec=No -port=<port number> + <database name></literal>. + </para> + <para> + Tous les prochains appels à <function>fbsql_query</function> se feront + dans la base <parameter>database_name</parameter>. + </para> + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database_name</parameter></term> + <listitem> + <para> + Le nom de la base de données à sélectionner. + </para> + <para> + Si la base de données est protégée avec un mot de passe, l'utilisateur doit + appeler la fonction <function>fbsql_database_password</function> avant + de sélectionner la base de données. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_connect</function></member> + <member><function>fbsql_pconnect</function></member> + <member><function>fbsql_database_password</function></member> + <member><function>fbsql_query</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -72,4 +97,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-set-lob-mode.xml Tue Jan 23 19:04:36 2007 @@ -1,65 +1,93 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-set-lob-mode"> - <refnamediv> - <refname>fbsql_set_lob_mode</refname> - <refpurpose> - Modifie le mode de lecture des LOB - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_set_lob_mode</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_set_lob_mode</function> retourne &true; - en cas de succès et &false; sinon. - </para> - <para> - <function>fbsql_set_lob_mode</function> modifie le mode de lecture - des LOB. Lorsque des données BLOB ou CLOB sont stockées dans une - base de données FrontBase, elles peuvent l'être de manière directe ou - indirecte. Si les données sont stockées directement, elles seront - automatiquement lues, quelque soit le mode choisi. Si un LOB fait - moins de 512 octets, il sera aussi stocké directement. - <itemizedlist> - <listitem> - <simpara> - FBSQL_LOB_DIRECT - les données LOB sont lues directements. - Lorsque les données sont lues dans la base avec - <function>fbsql_fetch_row</function> ou d'autres fonctions de lectures, - toutes les colonnes de type CLOB et BLOB seront retournées comme - des colonnes habituelles. C'est le comportement par défaut de - FrontBase. - </simpara> - </listitem> + +<refentry id="function.fbsql-set-lob-mode"> + <refnamediv> + <refname>fbsql_set_lob_mode</refname> + <refpurpose>Modifie le mode de lecture des LOB</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_set_lob_mode</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>lob_mode</parameter></methodparam> + </methodsynopsis> + <para> + Modifie le mode de lecture des LOB depuis la base de données. + </para> + <para> + Lorsque des données BLOB ou CLOB sont stockées dans une + base de données FrontBase, elles peuvent l'être de manière directe ou + indirecte. Si les données sont stockées directement, elles seront + automatiquement lues, quelque soit le mode choisi. Si un LOB fait + moins de 512 octets, il sera aussi stocké directement. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>lob_mode</parameter></term> <listitem> - <simpara> - FBSQL_LOB_HANDLE - Les données LOB sont lues sous forme - d'identifiants. Lorsque les données sont lues dans la base avec - <function>fbsql_fetch_row</function> ou d'autres fonctions de lecture, - toutes les colonnes de type CLOB et BLOB seront retournées - sous la forme d'un identifiant. Cet identifiant sera une chaîne de - 27 caractères de long, formatée comme ceci : - <literal>"@'000000000000000000000000'"</literal>. - </simpara> + <para> + Peut être un parmis : + <itemizedlist> + <listitem> + <simpara> + <constant>FBSQL_LOB_DIRECT</constant> - les données LOB sont lues directements. + Lorsque les données sont lues dans la base avec + <function>fbsql_fetch_row</function> ou d'autres fonctions de lectures, + toutes les colonnes de type CLOB et BLOB seront retournées comme + des colonnes habituelles. C'est le comportement par défaut de + FrontBase. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FBSQL_LOB_HANDLE</constant> - Les données LOB sont lues sous forme + d'identifiants. Lorsque les données sont lues dans la base avec + <function>fbsql_fetch_row</function> ou d'autres fonctions de lecture, + toutes les colonnes de type CLOB et BLOB seront retournées + sous la forme d'un identifiant. Cet identifiant sera une chaîne de + 27 caractères de long, formatée comme ceci : + <literal>"@'000000000000000000000000'"</literal>. + </simpara> + </listitem> + </itemizedlist> + </para> </listitem> - </itemizedlist> - </para> - <para> - Voir aussi - <function>fbsql_create_blob</function>, - <function>fbsql_create_clob</function>, - <function>fbsql_read_blob</function> et - <function>fbsql_read_clob</function>. - </para> - </refsect1> - </refentry> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_create_blob</function></member> + <member><function>fbsql_create_clob</function></member> + <member><function>fbsql_read_blob</function></member> + <member><function>fbsql_read_clob</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -80,4 +108,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml:1.3 phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml:1.4 --- phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml:1.3 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-set-password.xml Tue Jan 23 19:04:36 2007 @@ -1,28 +1,68 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-set-password"> - <refnamediv> - <refname>fbsql_set_password</refname> - <refpurpose> - Change le mot de passe de l'utilisateur spécifié - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_set_password</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam><type>string</type><parameter>user</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam><type>string</type><parameter>old_password</parameter></methodparam> - </methodsynopsis> - &warn.undocumented.func; +<refentry id="function.fbsql-set-password"> + <refnamediv> + <refname>fbsql_set_password</refname> + <refpurpose>Change le mot de passe de l'utilisateur spécifié</refpurpose> + </refnamediv> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_set_password</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam><type>string</type><parameter>user</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam><type>string</type><parameter>old_password</parameter></methodparam> + </methodsynopsis> + <para> + Change le mot de passe de l'utilisateur <parameter>user</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>user</parameter></term> + <listitem> + <para> + Le nom de l'utilisateur. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Le nouveau mot de passe à définir. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>old_password</parameter></term> + <listitem> + <para> + L'ancien mot de passe à remplacer. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -43,4 +83,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml:1.8 phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml:1.9 --- phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml:1.8 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-set-transaction.xml Tue Jan 23 19:04:36 2007 @@ -1,27 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-set-transaction"> - <refnamediv> - <refname>fbsql_set_transaction</refname> - <refpurpose> - Configure le verrouillage et l'isolation de transactions - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>void</type><methodname>fbsql_set_transaction</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>Locking</parameter></methodparam> - <methodparam><type>int</type><parameter>Isolation</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-set-transaction'> + <refnamediv> + <refname>fbsql_set_transaction</refname> + <refpurpose>Configure le verrouillage et l'isolation de transactions</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>fbsql_set_transaction</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam><type>int</type><parameter>locking</parameter></methodparam> + <methodparam><type>int</type><parameter>isolation</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>locking</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>isolation</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -42,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-start-db.xml Tue Jan 23 19:04:36 2007 @@ -1,35 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-start-db"> - <refnamediv> - <refname>fbsql_start_db</refname> - <refpurpose>Démarre une base de données FBSQL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_start_db</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>database_options</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_start_db</function> démarre la base de données - <parameter>database_name</parameter> sur la connexion - <parameter>link_identifier</parameter>. - </para> - <para> - &return.success; - </para> - <para> - Voir aussi - <function>fbsql_db_status</function> et - <function>fbsql_stop_db</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-start-db"> + <refnamediv> + <refname>fbsql_start_db</refname> + <refpurpose>Démarre une base de données FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_start_db</methodname> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>database_options</parameter></methodparam> + </methodsynopsis> + <para> + Démarre une base de données FBSQL. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database_name</parameter></term> + <listitem> + <para> + Le nom de la base de données. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>database_options</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_db_status</function></member> + <member><function>fbsql_stop_db</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -50,4 +84,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-stop-db.xml Tue Jan 23 19:04:36 2007 @@ -1,34 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-stop-db"> - <refnamediv> - <refname>fbsql_stop_db</refname> - <refpurpose>Stoppe une base de données FBSQL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_stop_db</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_stop_db</function> stoppe la base de données - <parameter>database_name</parameter> sur la connexion - <parameter>link_identifier</parameter>. - </para> - <para> - &return.success; - </para> - <para> - Voir aussi - <function>fbsql_db_status</function> et - <function>fbsql_start_db</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-stop-db"> + <refnamediv> + <refname>fbsql_stop_db</refname> + <refpurpose>Stoppe une base de données FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_stop_db</methodname> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Stoppe une base de données FBSQL sur un serveur local ou distant. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database_name</parameter></term> + <listitem> + <para> + Le nom de la base de données. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_db_status</function></member> + <member><function>fbsql_start_db</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -49,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-tablename.xml Tue Jan 23 19:04:36 2007 @@ -1,45 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-tablename"> - <refnamediv> - <refname>fbsql_tablename</refname> - <refpurpose>Lit le nom de la table d'un champ</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_tablename</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam><type>int</type><parameter>i</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_tablename</function> retourne le nom de la - table d'origine du champ <parameter>i</parameter>, dans le résultat - <parameter>result</parameter>. La fonction <function>fbsql_num_rows</function> - peut être utilisée pour connaître le nombre de tables dans un - résultat. - <example> - <title>Exemple avec <function>fbsql_tablename</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-tablename"> + <refnamediv> + <refname>fbsql_tablename</refname> + <refpurpose>Lit le nom de la table d'un champs</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_tablename</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>i</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_tablename</function> retourne le nom de la + table d'origine du champs <parameter>i</parameter>, dans le résultat + <parameter>result</parameter>. + </para> + <para> + La fonction <function>fbsql_num_rows</function> + peut être utilisée pour connaître le nombre de tables dans un + résultat. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result</parameter></term> + <listitem> + <para> + Un pointeur de résultat, retourné par la fonction + <function>fbsql_list_tables</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>i</parameter></term> + <listitem> + <para> + Index du champs de la table courante. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de la table, sous la forme d'une &string;. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_tablename</function></title> + <programlisting role="php"> <![CDATA[ <?php fbsql_connect("localhost", "_SYSTEM", ""); $result = fbsql_list_tables("wisconsin"); $i = 0; while ($i < fbsql_num_rows($result)) { - $tb_names[$i] = fbsql_tablename($result, $i); - echo $tb_names[$i] . "<br />"; - $i++; + $tb_names[$i] = fbsql_tablename($result, $i); + echo $tb_names[$i] . "<br />"; + $i++; } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -60,4 +104,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-username.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-username.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-username.xml:1.6 phpdoc-fr/reference/fbsql/functions/fbsql-username.xml:1.7 --- phpdoc-fr/reference/fbsql/functions/fbsql-username.xml:1.6 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-username.xml Tue Jan 23 19:04:36 2007 @@ -1,24 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-username"> - <refnamediv> - <refname>fbsql_username</refname> - <refpurpose>Lit ou définit le nom de login à utiliser avec une connexion</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_username</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-username'> + <refnamediv> + <refname>fbsql_username</refname> + <refpurpose>Lit ou définit le nom de login à utiliser avec une connexion</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_username</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam> + </methodsynopsis> + <para> + Lit ou définit le nom de login à utiliser avec la connexion. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>username</parameter></term> + <listitem> + <para> + Si fourni, il sera le nouveau nom de l'utilisateur à définir. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de l'utilisateur courant utilisé avec la connexion, + sous la forme d'une &string;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_password</function></member> + <member><function>fbsql_hostname</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -39,4 +77,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-warnings.xml Tue Jan 23 19:04:36 2007 @@ -1,29 +1,59 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-warnings"> - <refnamediv> - <refname>fbsql_warnings</refname> - <refpurpose>Active ou désactive les alertes FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_warnings</methodname> - <methodparam choice="opt"><type>bool</type><parameter>OnOff</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_warnings</function> retourne &true; si - les alertes sont actives et &false; en cas d'erreur. - </para> - <para> - <function>fbsql_warnings</function> active ou désactive les alertes - FrontBase suivant que <parameter>onoff</parameter> est à &true; - ou &false;. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-warnings"> + <refnamediv> + <refname>fbsql_warnings</refname> + <refpurpose>Active ou désactive les alertes FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_warnings</methodname> + <methodparam choice="opt"><type>bool</type><parameter>OnOff</parameter></methodparam> + </methodsynopsis> + <para> + Active ou désactive les alertes FrontBase. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>OnOff</parameter></term> + <listitem> + <para> + Si l'on doit activer ou non les alertes. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si les alertes sont actives, &false; sinon. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_errno</function></member> + <member><function>fbsql_error</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -44,4 +74,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file