cvs: phpdoc-fr /reference/fbsql/functions fbsql-affected-rows.xml fbsql-autocommit.xml fbsql-blob-size.xml fbsql-change-user.xml fbsql-clob-size.xml
fbsql-close.xml fbsql-commit.xml fbsql-connect.xml fbsql-create-blob.xml fbsql-create-clob.xml fbsql-create-db.xml fbsql-data-seek.xml
fbsql-database-password.xml fbsql-database.xml fbsql-db-query.xml fbsql-db-status.xml fbsql-drop-db.xml fbsql-errno.xml fbsql-error.xml
fbsql-fetch-array.xml fbsql-fetch-assoc.xml fbsql-fetch-field.xml fbsql-fetch-lengths.xml

From: Date: Tue, 23 Jan 2007 10:32:01 +0000
Subject: cvs: phpdoc-fr /reference/fbsql/functions fbsql-affected-rows.xml fbsql-autocommit.xml fbsql-blob-size.xml fbsql-change-user.xml fbsql-clob-size.xml
fbsql-close.xml fbsql-commit.xml fbsql-connect.xml fbsql-create-blob.xml fbsql-create-clob.xml fbsql-create-db.xml fbsql-data-seek.xml
fbsql-database-password.xml fbsql-database.xml fbsql-db-query.xml fbsql-db-status.xml fbsql-drop-db.xml fbsql-errno.xml fbsql-error.xml
fbsql-fetch-array.xml fbsql-fetch-assoc.xml fbsql-fetch-field.xml fbsql-fetch-lengths.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-5184@lists.php.net to get a copy of this message
yannick Tue Jan 23 10:32:01 2007 UTC Modified files: /phpdoc-fr/reference/fbsql/functions fbsql-affected-rows.xml fbsql-autocommit.xml fbsql-blob-size.xml fbsql-change-user.xml fbsql-clob-size.xml fbsql-close.xml fbsql-commit.xml fbsql-connect.xml fbsql-create-blob.xml fbsql-create-clob.xml fbsql-create-db.xml fbsql-database-password.xml fbsql-database.xml fbsql-data-seek.xml fbsql-db-query.xml fbsql-db-status.xml fbsql-drop-db.xml fbsql-errno.xml fbsql-error.xml fbsql-fetch-array.xml fbsql-fetch-assoc.xml fbsql-fetch-field.xml fbsql-fetch-lengths.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/fbsql/functions/fbsql-affected-rows.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-affected-rows.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-affected-rows.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-affected-rows.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-affected-rows.xml:1.10 Mon Aug 28 12:10:32 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-affected-rows.xml Tue Jan 23 10:32:00 2007 @@ -1,59 +1,75 @@ <?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-affected-rows"> - <refnamediv> - <refname>fbsql_affected_rows</refname> - <refpurpose> - Lit le nombre de lignes affectées par la dernière requête - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_affected_rows</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_affected_rows</function> retourne le nombre de - lignes affectées par la dernière requête INSERT, UPDATE ou DELETE, - effectuée avec la connexion représentée par - <parameter>link_identifier</parameter>. Si ce dernier n'est pas - spécifié, c'est la dernière connexion ouverte par - <function>fbsql_connect</function> qui sera utilisée. - </para> - <note> - <para> - Si vous utilisez les transactions, vous devez appeler - <function>fbsql_affected_rows</function> après votre requête - INSERT, UPDATE ou DELETE, et non après la validation. - </para> - </note> - <para> - Si la dernière requête DELETE ne contenait pas de clause WHERE, toutes - les lignes seront effacées, mais <function>fbsql_affected_rows</function> - retournera 0. - </para> - <note> - <para> - Lors d'une requête UPDATE, FrontBase ne modifie pas les lignes dont les - anciennes valeurs sont égales aux nouvelles. Cela fait que - <function>fbsql_affected_rows</function> ne retournera pas le nombre - de lignes traitées, mais le nombre de lignes affectées (modifiées) par - la requête. - </para> - </note> + +<refentry id="function.fbsql-affected-rows"> + <refnamediv> + <refname>fbsql_affected_rows</refname> + <refpurpose>Lit le nombre de lignes affectées par la dernière requête</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_affected_rows</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_affected_rows</function> retourne le nombre de + lignes affectées par la dernière requête INSERT, UPDATE ou DELETE, + effectuée avec la connexion représentée par + <parameter>link_identifier</parameter>. + </para> + <note> <para> - Si la dernière requête échoue, <function>fbsql_affected_rows</function> - retourne -1. + Si vous utilisez les transactions, vous devez appeler + <function>fbsql_affected_rows</function> après votre requête + INSERT, UPDATE ou DELETE, et non après la validation. </para> + </note> + <para> + Si la dernière requête DELETE ne contenait pas de clause WHERE, toutes + les lignes seront effacées, mais <function>fbsql_affected_rows</function> + retournera &zero;. + </para> + <note> <para> - Voir aussi - <function>fbsql_num_rows</function>. + Lors d'une requête UPDATE, FrontBase ne modifie pas les lignes dont les + anciennes valeurs sont égales aux nouvelles. Cela fait que + <function>fbsql_affected_rows</function> ne retournera pas le nombre + de lignes traitées, mais le nombre de lignes affectées (modifiées) par + la requête. </para> - </refsect1> - </refentry> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Si la dernière requête échoue, <function>fbsql_affected_rows</function> + retourne -1. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_num_rows</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -74,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-autocommit.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-autocommit.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-autocommit.xml:1.11 phpdoc-fr/reference/fbsql/functions/fbsql-autocommit.xml:1.12 --- phpdoc-fr/reference/fbsql/functions/fbsql-autocommit.xml:1.11 Mon Aug 28 12:10:32 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-autocommit.xml Tue Jan 23 10:32:00 2007 @@ -1,39 +1,74 @@ <?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-autocommit"> - <refnamediv> - <refname>fbsql_autocommit</refname> - <refpurpose>Active ou désactive la validation automatique</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_autocommit</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>OnOff</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_autocommit</function> retourne l'état courant - de la validation automatique, pour la connexion - <parameter>link_identifier</parameter>. - Si le paramètre <parameter>onoff</parameter> est fourni, et vaut - &true;, FBSQL va se mettre en mode d'auto-validation, et les requêtes - seront validées automatiquement si aucune erreur n'est - trouvée. - Si le paramètre <parameter>onoff</parameter> est fourni, et vaut - &false;, FBSQL va se mettre en mode de validation manuelle, et les requêtes - seront validées par l'appel de la fonction <function>fbsql_commit</function> - ou annulées par <function>fbsql_rollback</function>. - </para> - <para> - Voir aussi - <function>fbsql_commit</function> et - <function>fbsql_rollback</function> - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-autocommit"> + <refnamediv> + <refname>fbsql_autocommit</refname> + <refpurpose>Active ou désactive la validation automatique</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_autocommit</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>OnOff</parameter></methodparam> + </methodsynopsis> + <para> + Retourne l'état courant de la validation automatique. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>OnOff</parameter></term> + <listitem> + <para> + Si ce paramètre optionnel est fourni, le statut de l'auto-validation + sera changé. + </para> + <para> + Si le paramètre <parameter>onoff</parameter> vaut + &true;, FBSQL va se mettre en mode d'auto-validation, et les requêtes + seront validées automatiquement si aucune erreur n'est + trouvée. + </para> + <para> + Si le paramètre <parameter>onoff</parameter> vaut + &false;, FBSQL va se mettre en mode de validation manuelle, et les requêtes + seront validées par l'appel de la fonction <function>fbsql_commit</function> + ou annulées par <function>fbsql_rollback</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le statut courant de l'auto-validation, sous la forme d'un &boolean;. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_commit</function></member> + <member><function>fbsql_rollback</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -54,4 +89,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-blob-size.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-blob-size.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-blob-size.xml:1.3 phpdoc-fr/reference/fbsql/functions/fbsql-blob-size.xml:1.4 --- phpdoc-fr/reference/fbsql/functions/fbsql-blob-size.xml:1.3 Mon Aug 28 12:10:32 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-blob-size.xml Tue Jan 23 10:32:00 2007 @@ -1,26 +1,62 @@ <?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-blob-size"> - <refnamediv> - <refname>fbsql_blob_size</refname> - <refpurpose> - Retourne la taille d'un BLOB - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_blob_size</methodname> - <methodparam><type>string</type><parameter>blob_handle</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - &warn.undocumented.func; +<refentry id="function.fbsql-blob-size"> + <refnamediv> + <refname>fbsql_blob_size</refname> + <refpurpose>Retourne la taille d'un BLOB</refpurpose> + </refnamediv> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_blob_size</methodname> + <methodparam><type>string</type><parameter>blob_handle</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne la taille du BLOB fourni. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>blob_handle</parameter></term> + <listitem> + <para> + Un gestionnaire de 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 la taille du BLOB, sous la forme d'un &integer; + ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_clob_size</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -41,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-change-user.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-change-user.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-change-user.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-change-user.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-change-user.xml:1.9 Mon Aug 28 12:10:32 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-change-user.xml Tue Jan 23 10:32:00 2007 @@ -1,35 +1,71 @@ <?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-change-user"> - <refnamediv> - <refname>fbsql_change_user</refname> - <refpurpose> - Change le nom d'utilisateur de la session active - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_change_user</methodname> - <methodparam><type>string</type><parameter>user</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_change_user</function> change le nom de l'utilisateur - courant sur la session active courante, ou sur - <parameter>link_identifier</parameter>. Si une base de données - est spécifiée avec le paramètre <parameter>database</parameter>, elle - deviendra la base par défaut du nouvel utilisateur. - Le nouvel utilisateur doit être spécifié par son login - (<parameter>user</parameter>), et son mot de passe (<parameter>password</parameter>). - Si l'identification échoue, la session courante restera ouverte. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-change-user"> + <refnamediv> + <refname>fbsql_change_user</refname> + <refpurpose>Change le nom d'utilisateur de la session active</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_change_user</methodname> + <methodparam><type>string</type><parameter>user</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_change_user</function> change le nom de l'utilisateur + sur la session courante. Si l'identification du nouvel utilisateur échoue, + l'utilisateur courant reste actif. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>user</parameter></term> + <listitem> + <para> + Le nom du nouvel utilisateur. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Le mot de passe du nouvel utilisateur. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>database</parameter></term> + <listitem> + <para> + Si spécifié, ce sera la base de données par défaut après le changement + d'utilisateur. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.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: @@ -50,4 +86,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-clob-size.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-clob-size.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-clob-size.xml:1.3 phpdoc-fr/reference/fbsql/functions/fbsql-clob-size.xml:1.4 --- phpdoc-fr/reference/fbsql/functions/fbsql-clob-size.xml:1.3 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-clob-size.xml Tue Jan 23 10:32:00 2007 @@ -1,26 +1,62 @@ <?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-clob-size"> - <refnamediv> - <refname>fbsql_clob_size</refname> - <refpurpose> - Retourne la taille d'un CLOB - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_clob_size</methodname> - <methodparam><type>string</type><parameter>clob_handle</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - &warn.undocumented.func; +<refentry id="function.fbsql-clob-size"> + <refnamediv> + <refname>fbsql_clob_size</refname> + <refpurpose>Retourne la taille d'un CLOB</refpurpose> + </refnamediv> - </refsect1> - </refentry> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_clob_size</methodname> + <methodparam><type>string</type><parameter>clob_handle</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne la taille du CLOB fourni. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>clob_handle</parameter></term> + <listitem> + <para> + Un gestionnaire de 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 la taille du CLOB, sous la forme d'un &integer; + ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_blob_size</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -41,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-close.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-close.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-close.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-close.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-close.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-close.xml Tue Jan 23 10:32:00 2007 @@ -1,53 +1,76 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-close"> - <refnamediv> - <refname>fbsql_close</refname> - <refpurpose>Ferme la connexion FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_close</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_close</function> retourne &true; en - cas de succès et &false; en cas d'erreur. - </para> - <para> - <function>fbsql_close</function> ferme la connexion au serveur - FrontBase associée à la ressource <parameter>link_identifier</parameter>. - Si <parameter>link_identifier</parameter> est omis, c'est la dernière - connexion ouverte qui sera fermée. - </para> - <para> - Utiliser <function>fbsql_close</function> n'est pas nécessaire, - car les liens non persistants seront automatiquement - fermés à la fin du script. - </para> + +<refentry id="function.fbsql-close"> + <refnamediv> + <refname>fbsql_close</refname> + <refpurpose>Ferme la connexion FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_close</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Ferme la connexion au serveur FrontBase associée à la ressource spécifiée. + </para> + <para> + Utiliser <function>fbsql_close</function> n'est pas nécessaire, + car les liens non persistants seront automatiquement + fermés à la fin du script. + </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="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_close</function></title> <programlisting role="php"> <![CDATA[ <?php $link = fbsql_connect("localhost", "_SYSTEM", "secret") - or die("Impossible de se connecter"); -echo 'Connecté!'; + or die("Impossible de se connecter"); +echo "Connecté !"; fbsql_close($link); ?> ]]> </programlisting> </example> - <para> - Voir aussi - <function>fbsql_connect</function> et - <function>fbsql_pconnect</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_connect</function></member> + <member><function>fbsql_pconnect</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -68,4 +91,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-commit.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-commit.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-commit.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-commit.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-commit.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-commit.xml Tue Jan 23 10:32:00 2007 @@ -1,35 +1,55 @@ <?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-commit"> - <refnamediv> - <refname>fbsql_commit</refname> - <refpurpose>Valide une transaction</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_commit</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_commit</function> termine la transaction courante - en sauvant toutes les insertions, modifications et effacements sur - le serveur, puis en relachant tous les verrous qui ont été posés - sur les tables. Cette commande n'est nécessaire que si FBSQL est en - mode de validation manuelle. - </para> - <para> - &return.success; - </para> - <para> - Voir aussi - <function>fbsql_autocommit</function> et - <function>fbsql_rollback</function> - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-commit"> + <refnamediv> + <refname>fbsql_commit</refname> + <refpurpose>Valide une transaction</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_commit</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Termine la transaction courante en sauvant toutes les insertions, + modifications et effacements sur le serveur, puis en relachant tous + les verrous qui ont été posés sur les tables. Cette commande n'est + nécessaire que si FBSQL 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_rollback</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -50,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-connect.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-connect.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-connect.xml:1.11 phpdoc-fr/reference/fbsql/functions/fbsql-connect.xml:1.12 --- phpdoc-fr/reference/fbsql/functions/fbsql-connect.xml:1.11 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-connect.xml Tue Jan 23 10:32:00 2007 @@ -1,62 +1,111 @@ <?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-connect"> - <refnamediv> - <refname>fbsql_connect</refname> - <refpurpose>Ouvre une connexion à un serveur FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_connect</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_connect</function> retourne une ressource de connexion - positive en cas de succès, ou un message d'erreur en cas d'échec. - </para> - <para> - <function>fbsql_connect</function> établit une connexion avec - un serveur FrontBase. Les valeurs suivantes sont utilisées, en cas - d'omission : - <parameter>hostname</parameter> = '&null;', - <parameter>username</parameter> = '_SYSTEM' et - <parameter>password</parameter> = "" (pas de mot de passe). - </para> - <para> - Si un deuxième appel est fait à <function>fbsql_connect</function> - avec les mêmes arguments, une nouvelle connexion ne sera pas générée, - mais la connexion déjà ouverte sera réutilisée, et retournée. - </para> - <para> - La connexion au serveur sera fermée dès la fin du script, à moins qu'elle - ne soit explicitement terminée plus tôt, avec la fonction - <function>fbsql_close</function>. - </para> + +<refentry id="function.fbsql-connect"> + <refnamediv> + <refname>fbsql_connect</refname> + <refpurpose>Ouvre une connexion à un serveur FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_connect</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_connect</function> établit une connexion avec + un serveur FrontBase. + </para> + <para> + Si un deuxième appel est fait à <function>fbsql_connect</function> + avec les mêmes arguments, une nouvelle connexion ne sera pas générée, + mais la connexion déjà ouverte sera réutilisée, et retournée. + </para> + <para> + La connexion au serveur sera fermée dès la fin du script, à moins qu'elle + ne soit explicitement terminée plus tôt, avec la fonction + <function>fbsql_close</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hostname</parameter></term> + <listitem> + <para> + Le nom du serveur hôte. Par défaut, '&null;'. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>username</parameter></term> + <listitem> + <para> + Le nom de l'utilisateur pour la connexion. Par défaut, + <literal>_SYSTEM</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Le mot de passe pour la connexion. Par défaut, une chaîne vide. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une ressource de connexion positive FrontBase en cas de succès, + ou &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_connect</function></title> <programlisting role="php"> <![CDATA[ <?php + $link = fbsql_connect("localhost", "_SYSTEM", "secret") - or die("Impossible de se connecter"); -echo 'Connexion effectuée'; + or die("Impossible de se connecter"); +echo "Connexion effectuée !"; fbsql_close($link); + ?> ]]> </programlisting> </example> - <para> - Voir aussi - <function>fbsql_pconnect</function> et - <function>fbsql_close</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_pconnect</function></member> + <member><function>fbsql_close</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -77,4 +126,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-create-blob.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-create-blob.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-create-blob.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-create-blob.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-create-blob.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-create-blob.xml Tue Jan 23 10:32:00 2007 @@ -1,56 +1,91 @@ <?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-create-blob"> - <refnamediv> - <refname>fbsql_create_blob</refname> - <refpurpose>Crée un BLOB</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_create_blob</methodname> - <methodparam><type>string</type><parameter>blob_data</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_create_blob</function> retourne une ressource qui représente - le nouveau BLOB. - </para> - <para> - <function>fbsql_create_blob</function> crée un blob à partir - des données fournies par <parameter>blob_data</parameter>. La - ressource retournée est nécessaire aux commandes de modification - et d'insertion, pour sauver le BLOB dans la base de données. - </para> + +<refentry id="function.fbsql-create-blob"> + <refnamediv> + <refname>fbsql_create_blob</refname> + <refpurpose>Crée un BLOB</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_create_blob</methodname> + <methodparam><type>string</type><parameter>blob_data</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Crée un BLOB à partir des données fournies. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>blob_data</parameter></term> + <listitem> + <para> + Les données BLOB. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un gestionnaire de ressource BLOB qui peut être utilisé + avec les commandes insertions ou de mise à jour pour stocker le + BLOB dans la base de données. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_create_blob</function></title> <programlisting role="php"> <![CDATA[ <?php -$link = fbsql_pconnect ("localhost", "_SYSTEM", "secret") - or die ("Impossible de se connecter"); -$filename = 'blobfile.bin'; +$link = fbsql_pconnect("localhost", "_SYSTEM", "secret") + or die("Impossible de se connecter"); +$filename = "blobfile.bin"; $fp = fopen($filename, "rb"); $blobdata = fread($fp, filesize($filename)); fclose($fp); + $blobHandle = fbsql_create_blob($blobdata, $link); + $sql = "INSERT INTO BLOB_TABLE (BLOB_COLUMN) VALUES ($blobHandle);"; $rs = fbsql_query($sql, $link); ?> ]]> - </programlisting> - </example> - <para> - Voir aussi - <function>fbsql_create_clob</function>, - <function>fbsql_read_blob</function>, - <function>fbsql_read_clob</function> et - <function>fbsql_set_lob_mode</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </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_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: @@ -71,4 +106,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-create-clob.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-create-clob.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-create-clob.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-create-clob.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-create-clob.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-create-clob.xml Tue Jan 23 10:32:00 2007 @@ -1,56 +1,91 @@ <?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-create-clob"> - <refnamediv> - <refname>fbsql_create_clob</refname> - <refpurpose>Crée un CLOB</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_create_clob</methodname> - <methodparam><type>string</type><parameter>clob_data</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_create_clob</function> retourne une ressource qui représente - le nouveau CLOB. - </para> - <para> - <function>fbsql_create_clob</function> crée un clob à partir - des données fournies par <parameter>clob_data</parameter>. La - ressource retournée est nécessaire aux commandes de modification - et d'insertion, pour sauver le CLOB dans la base de données. - </para> - <example> - <title>Exemple avec <function>fbsql_create_clob</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-create-clob"> + <refnamediv> + <refname>fbsql_create_clob</refname> + <refpurpose>Crée un CLOB</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_create_clob</methodname> + <methodparam><type>string</type><parameter>clob_data</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Crée un CLOB à partir des données fournies. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>clob_data</parameter></term> + <listitem> + <para> + Les données CLOB. + </para> + </listitem> + </varlistentry> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un gestionnaire de ressource CLOB qui pourra être utilisé + avec les commandes d'insertion ou de mise à jour pour stocker le + CLOB dans la base de données. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_create_clob</function></title> + <programlisting role="php"> <![CDATA[ <?php -$link = fbsql_pconnect ("localhost", "_SYSTEM", "secret") - or die ("Impossible de se connecter"); -$filename = 'clob_file.txt'; +$link = fbsql_pconnect("localhost", "_SYSTEM", "secret") + or die("Impossible de se connecter"); +$filename = "clob_file.txt"; $fp = fopen($filename, "rb"); $clobdata = fread($fp, filesize($filename)); fclose($fp); + $clobHandle = fbsql_create_clob($clobdata, $link); + $sql = "INSERT INTO CLOB_TABLE (CLOB_COLUMN) VALUES ($clobHandle);"; $rs = fbsql_query($sql, $link); ?> ]]> - </programlisting> - </example> - <para> - Voir aussi - <function>fbsql_create_blob</function>, - <function>fbsql_read_blob</function>, - <function>fbsql_read_clob</function> et - <function>fbsql_set_lob_mode</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_create_blob</function></member> + <member><function>fbsql_read_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: @@ -71,4 +106,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-create-db.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-create-db.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-create-db.xml:1.12 phpdoc-fr/reference/fbsql/functions/fbsql-create-db.xml:1.13 --- phpdoc-fr/reference/fbsql/functions/fbsql-create-db.xml:1.12 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-create-db.xml Tue Jan 23 10:32:00 2007 @@ -1,47 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-create-db"> - <refnamediv> - <refname>fbsql_create_db</refname> - <refpurpose>Crée une base de données</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_create_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_create_db</function> crée une nouvelle base - de données, nommée <parameter>database_name</parameter>, sur - le serveur repéré par la ressource <parameter>link_identifier</parameter>. - </para> + +<refentry id="function.fbsql-create-db"> + <refnamediv> + <refname>fbsql_create_db</refname> + <refpurpose>Crée une base de données</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_create_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> + Tente de créer une nouvelle base de données sur le serveur spécifié. + </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, sous la forme d'une &string;. + </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="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_create_db</function></title> <programlisting role="php"> <![CDATA[ <?php $link = fbsql_pconnect("localhost", "_SYSTEM", "secret") - or die("Impossible de se connecter"); + or die("Impossible de se connecter"); if (fbsql_create_db("my_db")) { - echo "Base de données créée!\n"; + echo "Base de données créée avec succès\n"; } else { - printf("Erreur de création de la base de données : %s\n", fbsql_error()); + printf("Erreur de création de la base de données : %s\n", fbsql_error()); } ?> ]]> </programlisting> </example> - <para> - Voir aussi - <function>fbsql_drop_db</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_drop_db</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -62,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-database-password.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-database-password.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-database-password.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-database-password.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-database-password.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-database-password.xml Tue Jan 23 10:32:00 2007 @@ -1,63 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-database-password"> - <refnamediv> - <refname>fbsql_database_password</refname> - <refpurpose> - Modifie/lit le mot de passe dans une base FBSQL - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_database_password</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>database_password</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_database_password</function> retourne le mot de - passe du serveur représenté par <parameter>link_identifier</parameter>. - </para> - <para> - <function>fbsql_database_password</function> modifie et lit - le mot de passe de la base de données courante. Si le second paramètre - <parameter>database_password</parameter> est fourni, - <function>fbsql_database_password</function> remplacera le mot de - passe courant par celui-ci. Si aucun serveur n'est précisé car - le paramètre <parameter>link_identifier</parameter> n'est pas - fourni, la dernière connexion ouverte sera utilisée. Si aucune - connexion n'a été ouverte &php; essaiera d'en ouvrir une en - appelant la fonction <function>fbsql_connect</function>, et en - utilisant la connexion qui en résultera (si elle réussit). - </para> - <para> - Cette fonction ne modifie pas le mot de passe d'accès au serveur - qui est stocké sur le serveur, et elle ne permet pas non plus d'aller - lire ce mot de passe. - </para> - <example> - <title>Exemple avec <function>fbsql_create_clob</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-database-password"> + <refnamediv> + <refname>fbsql_database_password</refname> + <refpurpose>Modifie/lit le mot de passe dans une base FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_database_password</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>database_password</parameter></methodparam> + </methodsynopsis> + <para> + Modifie et lit le mot de passe de la base de données courante. Si la + base de données est protégée par un mot de passe, l'utilisateur + doit appeler cette fonction avant d'appeler la fonction + <function>fbsql_select_db</function>. + </para> + <para> + Si aucune connexion n'a été ouverte &php; essaiera d'en ouvrir une en + appelant la fonction <function>fbsql_connect</function>, et en + utilisant la connexion qui en résultera (si elle réussit). + </para> + <para> + Cette fonction ne modifie pas le mot de passe d'accès au serveur + qui est stocké sur le serveur, et elle ne permet pas non plus d'aller + lire ce mot de passe. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>database_password</parameter></term> + <listitem> + <para> + Le mot de passe, sous la forme d'une &string;. Si fourni, la fonction + définira le mot de passe de base de données pour la connexion + courante. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le mot de passe de base de données associé à la connexion + courante. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_create_clob</function></title> + <programlisting role="php"> <![CDATA[ <?php -$link = fbsql_pconnect ("localhost", "_SYSTEM", "secret") - or die ("Impossible de se connecter"); -fbsql_database_password($link, "mot de passe secret"); +$link = fbsql_pconnect("localhost", "_SYSTEM", "secret") + or die("Impossible de se connecter"); +fbsql_database_password($link, "secret db password"); fbsql_select_db($database, $link); ?> ]]> - </programlisting> - </example> - <para> - Voir aussi - <function>fbsql_select_db</function>, - <function>fbsql_connect</function> et - <function>fbsql_pconnect</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_connect</function></member> + <member><function>fbsql_pconnect</function></member> + <member><function>fbsql_select_db</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -78,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-database.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-database.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-database.xml:1.6 phpdoc-fr/reference/fbsql/functions/fbsql-database.xml:1.7 --- phpdoc-fr/reference/fbsql/functions/fbsql-database.xml:1.6 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-database.xml Tue Jan 23 10:32:00 2007 @@ -1,24 +1,51 @@ <?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-database"> - <refnamediv> - <refname>fbsql_database</refname> - <refpurpose>Lit ou définit le nom de la base de données utilisée avec une connexion</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_database</methodname> - <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.fbsql-database'> + <refnamediv> + <refname>fbsql_database</refname> + <refpurpose>Lit ou définit le nom de la base de données utilisée avec une connexion</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_database</methodname> + <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> + </methodsynopsis> + <para> + Lit ou définit le nom de la base de données utilisée avec la connexion fournie. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + <varlistentry> + <term><parameter>database</parameter></term> + <listitem> + <para> + Le nom de la base de données. Si fourni, la base de données par défaut + pour la connexion sera changé en <parameter>database</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de la base de données utilisée avec cette connexion. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -39,4 +66,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-data-seek.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-data-seek.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-data-seek.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-data-seek.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-data-seek.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-data-seek.xml Tue Jan 23 10:32:00 2007 @@ -1,65 +1,97 @@ <?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-data-seek"> - <refnamediv> - <refname>fbsql_data_seek</refname> - <refpurpose>Déplace le pointeur interne de résultat FBSQL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_data_seek</methodname> - <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>row_number</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_data_seek</function> déplace le pointeur interne - de ligne dans le résultat de requête <parameter>result_identifier</parameter> - jusqu'à la ligne <parameter>row_number</parameter>. Le prochain - appel à <function>fbsql_fetch_row</function> retournera cette ligne. - </para> - <para> - &return.success; - </para> - <para> - Les lignes sont numérotées à partir de 0. - </para> + +<refentry id="function.fbsql-data-seek"> + <refnamediv> + <refname>fbsql_data_seek</refname> + <refpurpose>Déplace le pointeur interne de résultat FBSQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_data_seek</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>row_number</parameter></methodparam> + </methodsynopsis> + <para> + Déplace le pointeur interne de ligne dans le résultat de requête + <parameter>result_identifier</parameter> jusqu'à la ligne + <parameter>row_number</parameter>. + </para> + <para> + Le prochain appel à la fonction <function>fbsql_fetch_row</function> + retournera cette ligne. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>row_number</parameter></term> + <listitem> + <para> + Le numéro de la ligne. Commence à 0. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_data_seek</function></title> <programlisting role="php"> <![CDATA[ <?php - $link = fbsql_pconnect("localhost", "_SYSTEM", "secret") - or die ("Impossible de se connecter"); + or die("Impossible de se connecter"); + fbsql_select_db("samp_db") - or die ("Impossible de sélectionner une base"); + or die("Impossible de sélectionner une base"); + $query = "SELECT last_name, first_name FROM friends;"; $result = fbsql_query($query) - or die ("La requête est mauvaise"); + or die("La requête a échoué"); // Lecture des lignes en ordre inverse + for ($i = fbsql_num_rows($result) - 1; $i >=0; $i--) { + if (!fbsql_data_seek($result, $i)) { + printf("Impossible d'accéder à la ligne %d\n", $i); + continue; + } - if (!fbsql_data_seek($result, $i)) { - printf ("Impossible d'accéder à la ligne %d\n", $i); - continue; - } - if(!($row = fbsql_fetch_object($result))) { - continue; - } + if (!($row = fbsql_fetch_object($result))) + continue; - echo $row->last_name . $row->first_name . "<br />\n"; + echo $row->last_name . $row->first_name . "<br />\n"; } + fbsql_free_result($result); ?> ]]> </programlisting> </example> - </refsect1> - </refentry> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -80,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-db-query.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-db-query.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-db-query.xml:1.8 phpdoc-fr/reference/fbsql/functions/fbsql-db-query.xml:1.9 --- phpdoc-fr/reference/fbsql/functions/fbsql-db-query.xml:1.8 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-db-query.xml Tue Jan 23 10:32:00 2007 @@ -1,41 +1,75 @@ <?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-db-query"> - <refnamediv> - <refname>fbsql_db_query</refname> - <refpurpose>Envoie une requête à la base FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>fbsql_db_query</methodname> - <methodparam><type>string</type><parameter>database</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_db_query</function> retourne une ressource positive - représentant un résultat de requête en cas de succès, et - &false; en cas d'erreur. - </para> - <para> - <function>fbsql_db_query</function> sélectionne la base <parameter>database</parameter> - et y exécute la requête <parameter>query</parameter>. Si le paramètre - optionnel <parameter>link_identifier</parameter> est spécifié, - <function>fbsql_db_query</function> travaillera sur cette connexion. - S'il est omis, <function>fbsql_db_query</function> essaiera d'utiliser - la dernière connexion ouverte. Si aucune connexion n'a été ouverte, - <function>fbsql_db_query</function> essaiera de se connecter automatiquement - en appelant la fonction <function>fbsql_connect</function>, sans argument. - </para> - <para> - Voir aussi - <function>fbsql_connect</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-db-query"> + <refnamediv> + <refname>fbsql_db_query</refname> + <refpurpose>Envoie une requête à la base FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>fbsql_db_query</methodname> + <methodparam><type>string</type><parameter>database</parameter></methodparam> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Sélectionne une base de données et y exécute une requête. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>database</parameter></term> + <listitem> + <para> + La base de données à sélectionner. + </para> + </listitem> + </varlistentry> + <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; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un identifiant de résultat positif FrontBase ou &false; + si une erreur survient. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_query</function></member> + <member><function>fbsql_connect</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -56,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-db-status.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-db-status.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-db-status.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-db-status.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-db-status.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-db-status.xml Tue Jan 23 10:32:00 2007 @@ -1,82 +1,105 @@ <?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-db-status"> - <refnamediv> - <refname>fbsql_db_status</refname> - <refpurpose>Lit le statut courant d'une base de données</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_db_status</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_db_status</function> retourne un entier - représentant le statut courant. - </para> - <para> - <function>fbsql_db_status</function> demande le statut de la base - de données nommée <parameter>database_name</parameter>. Si le - paramètre <parameter>link_identifier</parameter> est omis, la - connexion par défaut sera utilisée. - </para> - <para> - La valeur de l'entier peut être l'une des suivantes : - <itemizedlist> - <listitem> - <simpara> - &false; - Le gestion de cet hôte était invalide. Cette erreur - survient lorsque &php; se connecte directement à une base de données - en utilisant un numéro de port. FBExec peut être disponible sur - un serveur, mais aucune connexion n'a été faite. - </simpara> - </listitem> - <listitem> - <simpara> - FBSQL_UNKNOWN - Le statut est inconnu. - </simpara> - </listitem> - <listitem> - <simpara> - FBSQL_STOPPED - La base de données ne fonctionne pas. Utilisez - <function>fbsql_start_db</function> pour démarrer la base. - </simpara> - </listitem> - <listitem> - <simpara> - FBSQL_STARTING - La base de données démarre. - </simpara> - </listitem> - <listitem> - <simpara> - FBSQL_RUNNING - La base de données fonctionne, et est - disponible pour recevoir des requêtes SQL. - </simpara> - </listitem> - <listitem> - <simpara> - FBSQL_STOPPING - La base de données s'arrête. - </simpara> - </listitem> - <listitem> - <simpara> - FBSQL_NOEXEC - FBExec ne fonctionne par sur le serveur, et - il n'est pas possible d'obtenir le statut de la base de données. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Voir aussi - <function>fbsql_start_db</function> et - <function>fbsql_stop_db</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-db-status"> + <refnamediv> + <refname>fbsql_db_status</refname> + <refpurpose>Lit le statut courant d'une base de données</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_db_status</methodname> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Lit le statut courant de la base de données 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> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un &integer; correspondant au statut courant. Il peut être + une des constantes suivantes : + <itemizedlist> + <listitem> + <simpara> + &false; - Le gestion de cet hôte était invalide. Cette erreur + survient lorsque &php; se connecte directement à une base de données + en utilisant un numéro de port. FBExec peut être disponible sur + un serveur, mais aucune connexion n'a été faite. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FBSQL_UNKNOWN</constant> - Le statut est inconnu. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FBSQL_STOPPED</constant> - La base de données ne fonctionne pas. Utilisez + <function>fbsql_start_db</function> pour démarrer la base. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FBSQL_STARTING</constant> - La base de données démarre. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FBSQL_RUNNING</constant> - La base de données fonctionne, et est + disponible pour recevoir des requêtes SQL. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FBSQL_STOPPING</constant> - La base de données s'arrête. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FBSQL_NOEXEC</constant> - FBExec ne fonctionne par sur le serveur, et + il n'est pas possible d'obtenir le statut de la base de données. + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_start_db</function></member> + <member><function>fbsql_stop_db</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -97,4 +120,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-drop-db.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-drop-db.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-drop-db.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-drop-db.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-drop-db.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-drop-db.xml Tue Jan 23 10:32:00 2007 @@ -1,29 +1,62 @@ <?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-drop-db"> - <refnamediv> - <refname>fbsql_drop_db</refname> - <refpurpose>Supprime une base de données FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fbsql_drop_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_drop_db</function> essaie de supprimer la base - de données <parameter>database_name</parameter>, sur la connexion - représentée par <parameter>link_identifier</parameter>. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-drop-db"> + <refnamediv> + <refname>fbsql_drop_db</refname> + <refpurpose>Supprime une base de données FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fbsql_drop_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_drop_db</function> essaie de supprimer la base + de données <parameter>database_name</parameter>, sur la connexion + représentée par <parameter>link_identifier</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. + </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_create_db</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -44,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-errno.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-errno.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-errno.xml:1.12 phpdoc-fr/reference/fbsql/functions/fbsql-errno.xml:1.13 --- phpdoc-fr/reference/fbsql/functions/fbsql-errno.xml:1.12 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-errno.xml Tue Jan 23 10:32:00 2007 @@ -1,54 +1,84 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-errno"> - <refnamediv> - <refname>fbsql_errno</refname> - <refpurpose>Retourne le code d'erreur FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fbsql_errno</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_errno</function> retourne le code d'erreur de la - dernière connexion FrontBase, ou bien - &zero; (zéro) si aucune erreur n'est survenue. - </para> - <para> - Les erreurs générées par FrontBase ne sont pas automatiquement - affichées comme alertes. Il faut utiliser la fonction <function>fbsql_errno</function> - pour connaître leur code d'erreur. Notez que cette fonction ne - retourne que le code d'erreur généré par la dernière fonction FrontBase - (hormis <function>fbsql_error</function> et - <function>fbsql_errno</function>) : si vous voulez repérer les - erreurs, faites-le dès que les fonctions ont été appelées. - <example> - <title>Exemple avec <function>fbsql_errno</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-errno"> + <refnamediv> + <refname>fbsql_errno</refname> + <refpurpose>Retourne le code d'erreur FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fbsql_errno</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le code d'erreur de la dernière opération + sur la connexion FrontBase fournie. + </para> + <para> + Les erreurs générées par FrontBase ne sont pas automatiquement + affichées comme alertes. Il faut utiliser la fonction <function>fbsql_errno</function> + pour connaître leur code d'erreur. Notez que cette fonction ne + retourne que le code d'erreur généré par la dernière fonction FrontBase + (hormis <function>fbsql_error</function> et + <function>fbsql_errno</function>) : si vous voulez repérer les + erreurs, faites-le dès que les fonctions ont été appelées. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le numéro de l'erreur généré par la dernière fonction + fbsql ou &zero; si aucune erreur survient. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_errno</function></title> + <programlisting role="php"> <![CDATA[ <?php fbsql_connect("marliesle"); -echo fbsql_errno() . ' : ' . fbsql_error() . '<br />'; +echo fbsql_errno() . ": " . fbsql_error() . "<br />"; fbsql_select_db("nonexistentdb"); -echo fbsql_errno() . ' : ' . fbsql_error() . '<br />'; +echo fbsql_errno() . ": " . fbsql_error() . "<br />"; $conn = fbsql_query("SELECT * FROM nonexistenttable;"); -echo fbsql_errno() . ' : ' . fbsql_error() . '<br />'; +echo fbsql_errno() . ": " . fbsql_error() . "<br />"; ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>fbsql_error</function> et - <function>fbsql_warnings</function> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_error</function></member> + <member><function>fbsql_warnings</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -69,4 +99,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-error.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-error.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-error.xml:1.11 phpdoc-fr/reference/fbsql/functions/fbsql-error.xml:1.12 --- phpdoc-fr/reference/fbsql/functions/fbsql-error.xml:1.11 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-error.xml Tue Jan 23 10:32:00 2007 @@ -1,54 +1,84 @@ <?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-error"> - <refnamediv> - <refname>fbsql_error</refname> - <refpurpose>Retourne le message d'erreur FrontBase</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fbsql_error</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_error</function> retourne le dernier message d'erreur - généré par le serveur FrontBase, ou bien - <literal>''</literal> (chaîne vide) si aucune erreur n'est survenue. - </para> - <para> - Les erreurs générées par FrontBase ne sont pas automatiquement - affichées comme alertes. Il faut utiliser la fonction <function>fbsql_errno</function> - pour connaître leur code d'erreur. Notez que cette fonction ne - retourne que le code d'erreur généré par la dernière fonction FrontBase - (hormis <function>fbsql_error</function> et - <function>fbsql_errno</function>) : si vous voulez repérer les - erreurs, faites-le dès que les fonctions ont été appelées. - <example> - <title>Exemple avec <function>fbsql_error</function></title> - <programlisting role="php"> + +<refentry id="function.fbsql-error"> + <refnamediv> + <refname>fbsql_error</refname> + <refpurpose>Retourne le message d'erreur FrontBase</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fbsql_error</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le dernier message d'erreur généré par le serveur FrontBase. + </para> + <para> + Les erreurs générées par FrontBase ne sont pas automatiquement + affichées comme alertes. Il faut utiliser la fonction <function>fbsql_errno</function> + pour connaître leur code d'erreur. Notez que cette fonction ne + retourne que le code d'erreur généré par la dernière fonction FrontBase + (hormis <function>fbsql_error</function> et + <function>fbsql_errno</function>) : si vous voulez repérer les + erreurs, faites-le dès que les fonctions ont été appelées. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.link-identifier.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le texte de l'erreur générée par la dernière fonction + fbsql ou <literal>''</literal> (une chaîne vide) si aucune + erreur n'est survenue. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>fbsql_error</function></title> + <programlisting role="php"> <![CDATA[ <?php fbsql_connect("marliesle"); -echo fbsql_errno() . ' : ' . fbsql_error() . '<br />'; +echo fbsql_errno() . ": " . fbsql_error() . "<br />"; fbsql_select_db("nonexistentdb"); -echo fbsql_errno() . ' : ' . fbsql_error() . '<br />'; +echo fbsql_errno() . ": " . fbsql_error() . "<br />"; $conn = fbsql_query("SELECT * FROM nonexistenttable;"); -echo fbsql_errno() . ' : ' . fbsql_error() . '<br />'; +echo fbsql_errno() . ": " . fbsql_error() . "<br />"; ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>fbsql_errno</function> et - <function>fbsql_warnings</function> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_errno</function></member> + <member><function>fbsql_warnings</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -69,4 +99,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-array.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-fetch-array.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-fetch-array.xml:1.15 phpdoc-fr/reference/fbsql/functions/fbsql-fetch-array.xml:1.16 --- phpdoc-fr/reference/fbsql/functions/fbsql-fetch-array.xml:1.15 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-fetch-array.xml Tue Jan 23 10:32:00 2007 @@ -1,79 +1,114 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fbsql-fetch-array"> - <refnamediv> - <refname>fbsql_fetch_array</refname> - <refpurpose>Lit toute une ligne de résultat dans un tableau</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>fbsql_fetch_array</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_array</function> retourne un tableau contenant - la ligne courante du résultat <parameter>result</parameter>, ou - &false; s'il n'y a plus de ligne. - </para> - <para> - <function>fbsql_fetch_array</function> est une version améliorée - de <function>fbsql_fetch_row</function>. En plus de stocker les - données dans un tableau indexé, elle les stocke - aussi sous forme de tableau associatif, dont les clés sont - les noms des colonnes. - </para> - <para> - Si deux colonnes (ou plus) ont le même nom, la dernière colonne - sera utilisée. Pour accéder aux autres colonnes de même nom, vous - devez absolument utiliser les indices numériques. - <example> - <title>Exemple avec <function>fbsql_fetch_array</function></title> - <programlisting role="sql"> + +<refentry id="function.fbsql-fetch-array"> + <refnamediv> + <refname>fbsql_fetch_array</refname> + <refpurpose>Lit toute une ligne de résultat dans un tableau</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>fbsql_fetch_array</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_array</function> est une combinaison de + <function>fbsql_fetch_row</function> et + <function>fbsql_fetch_assoc</function>. + </para> + <para> + Il est important de noter que <function>fbsql_fetch_array</function> + n'est pas significativement plus lente que <function>fbsql_fetch_row</function>, + tandis qu'elle apporte un confort d'utilisation notable. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>result_type</parameter></term> + <listitem> + <para> + Une constante et peut prendre les valeurs suivantes : + <constant>FBSQL_ASSOC</constant>, <constant>FBSQL_NUM</constant>, ou + <constant>FBSQL_BOTH</constant>. + </para> + <para> + Lors de l'utilisation de <constant>FBSQL_BOTH</constant>, en plus de + stocker les indices numériques du tableau de résultats, il stockera les + données dans des indices associatifs, en utilisant les noms des champs + comme clés. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau qui correspond à la ligne récupérée, ou &false; + s'il y a plus de ligne de disponible. + </para> + <para> + Si deux colonnes (ou plus) ont le même nom, la dernière colonne + sera utilisée. Pour accéder aux autres colonnes de même nom, vous + devez absolument utiliser les indices numériques. + <informalexample> + <programlisting role="sql"> <![CDATA[ select t1.f1 as foo t2.f1 as bar from t1, t2 ]]> - </programlisting> - </example> - </para> - <para> - Il est important de noter que <function>fbsql_fetch_array</function> - n'est pas significativement plus lente que <function>fbsql_fetch_row</function>, - tandis qu'elle apporte un confort d'utilisation notable. - </para> - <para> - Le second argument optionnel <parameter>result_type</parameter> - de <function>fbsql_fetch_array</function> est une constante qui peut prendre - l'une des valeurs suivantes : <literal>FBSQL_ASSOC</literal>, - <literal>FBSQL_NUM</literal> et <literal>FBSQL_BOTH</literal>. - </para> - <para> - Pour plus de détails, reportez-vous à - <function>fbsql_fetch_row</function> et <function>fbsql_fetch_assoc</function>. - </para> + </programlisting> + </informalexample> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_fetch_array</function></title> <programlisting role="php"> <![CDATA[ <?php fbsql_connect($host, $user, $password); -$result = fbsql_db_query("database","select user_id, fullname from table"); +$result = fbsql_db_query("database", "select user_id, fullname from table"); while ($row = fbsql_fetch_array($result)) { - echo 'user_id : ' . $row["user_id"] . "<br />\n"; - echo 'user_id : ' . $row[0] . "<br />\n"; - echo 'Nom complet : ' . $row["fullname"] . "<br />\n"; - echo 'Nom complet : ' . $row[1] . "<br />\n"; + echo "user_id: " . $row["user_id"] . "<br />\n"; + echo "user_id: " . $row[0] . "<br />\n"; + echo "Nom complet : " . $row["fullname"] . "<br />\n"; + echo "Nom complet : " . $row[1] . "<br />\n"; } - fbsql_free_result($result); +fbsql_free_result($result); ?> ]]> </programlisting> </example> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_fetch_row</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: @@ -94,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-fetch-assoc.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-fetch-assoc.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-fetch-assoc.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-fetch-assoc.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-fetch-assoc.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-fetch-assoc.xml Tue Jan 23 10:32:00 2007 @@ -1,65 +1,94 @@ <?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-fetch-assoc"> - <refnamediv> - <refname>fbsql_fetch_assoc</refname> - <refpurpose> - Lit toute une ligne de résultat dans un tableau associatif - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>fbsql_fetch_assoc</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_fetch_assoc</function> retourne un tableau associatif - contenant la ligne courante du résultat <parameter>result</parameter>, ou - &false; s'il n'y a plus de lignes. - </para> - <para> - <function>fbsql_fetch_assoc</function> est équivalent à - <function>fbsql_fetch_array</function> avec l'option - <literal>FBSQL_ASSOC</literal>. Elle ne retourne qu'un tableau - associatif. C'est le comportement initial de <function>fbsql_fetch_array</function>. - Si vous avez aussi besoin des indices numériques, utilisez - <function>fbsql_fetch_array</function>. - </para> - <para> - Si deux colonnes (ou plus) ont le même nom, la dernière colonne - sera utilisée. Pour accéder aux autres colonnes de même nom, vous - devez absolument utiliser la fonction <function>fbsql_fetch_array</function>. - </para> - <para> - Il est important de noter que <function>fbsql_fetch_assoc</function> - n'est pas significativement plus lente que <function>fbsql_fetch_row</function>, - tandis qu'elle apporte un confort d'utilisation notable. - </para> - <para> - Pour plus de détails, reportez-vous à - <function>fbsql_fetch_row</function> et <function>fbsql_fetch_array</function>. - </para> + +<refentry id="function.fbsql-fetch-assoc"> + <refnamediv> + <refname>fbsql_fetch_assoc</refname> + <refpurpose>Lit toute une ligne de résultat dans un tableau associatif</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>fbsql_fetch_assoc</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + <function>fbsql_fetch_assoc</function> est équivalent à + <function>fbsql_fetch_array</function> avec l'option + <literal>FBSQL_ASSOC</literal>. Elle ne retourne qu'un tableau + associatif. + </para> + <para> + C'est le comportement initial de <function>fbsql_fetch_array</function>. + Si vous avez aussi besoin des indices numériques, utilisez + <function>fbsql_fetch_array</function>. + </para> + <para> + Il est important de noter que <function>fbsql_fetch_assoc</function> + n'est pas significativement plus lente que <function>fbsql_fetch_row</function>, + tandis qu'elle apporte un confort d'utilisation notable. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif contenant la ligne courante du résultat, + ou &false; s'il n'y a plus de lignes. + </para> + <para> + Si deux colonnes (ou plus) ont le même nom, la dernière colonne + sera utilisée. Pour accéder aux autres colonnes de même nom, vous + devez absolument utiliser la fonction <function>fbsql_fetch_array</function>. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_fetch_assoc</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_assoc($result)) { - echo $row["user_id"]; - echo $row["fullname"]; + echo $row["user_id"]; + echo $row["fullname"]; } fbsql_free_result($result); ?> ]]> </programlisting> </example> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_fetch_row</function></member> + <member><function>fbsql_fetch_array</function></member> + <member><function>fbsql_fetch_object</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -80,4 +109,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-field.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-fetch-field.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-fetch-field.xml:1.10 phpdoc-fr/reference/fbsql/functions/fbsql-fetch-field.xml:1.11 --- phpdoc-fr/reference/fbsql/functions/fbsql-fetch-field.xml:1.10 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-fetch-field.xml Tue Jan 23 10:32:00 2007 @@ -1,98 +1,130 @@ <?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-field"> - <refnamediv> - <refname>fbsql_fetch_field</refname> - <refpurpose> - Lit des informations sur une colonne dans un résultat, et retourne un objet - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>object</type><methodname>fbsql_fetch_field</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_fetch_field</function> retourne une objet contenant - les informations sur un champ, dans le résultat <parameter>result</parameter>. - </para> - <para> - <function>fbsql_fetch_field</function> sert à lire des informations - sur les champs dans le résultat <parameter>result</parameter>. Si le - second paramètre <parameter>field_offset</parameter> n'est pas - spécifié, le champ suivant est lu. - </para> - <para> - Les propriétés de l'objet sont : - <itemizedlist> - <listitem> - <simpara> - name - Nom de colonne - </simpara> - </listitem> - <listitem> - <simpara> - table - Nom de la table d'origine - </simpara> - </listitem> - <listitem> - <simpara> - max_length - Taille maximale de la colonne - </simpara> - </listitem> - <listitem> - <simpara> - not_null - 1 si la colonne ne peut être nulle - </simpara> - </listitem> + +<refentry id="function.fbsql-fetch-field"> + <refnamediv> + <refname>fbsql_fetch_field</refname> + <refpurpose>Lit des informations sur une colonne dans un résultat, et retourne un objet</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>object</type><methodname>fbsql_fetch_field</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>field_offset</parameter></methodparam> + </methodsynopsis> + <para> + Sert à lire des informations sur les champs dans le résultat fourni. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + <varlistentry> + <term><parameter>field_offset</parameter></term> <listitem> - <simpara> - type - Type de la colonne - </simpara> + <para> + L'offset numérique du champs. L'index du champs commence à 0. + Si aucun n'est spécifié, le prochain champs qui n'a pas été + récupéré par la fonction <function>fbsql_fetch_field</function> + sera retourné. + </para> </listitem> - </itemizedlist> - </para> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un objet contenant les informations sur le champs ou &false; + si une erreur survient. + </para> + <para> + Les propriétés de l'objet sont : + <itemizedlist> + <listitem> + <simpara> + name - Nom de colonne + </simpara> + </listitem> + <listitem> + <simpara> + table - Nom de la table d'origine + </simpara> + </listitem> + <listitem> + <simpara> + max_length - Taille maximale de la colonne + </simpara> + </listitem> + <listitem> + <simpara> + not_null - 1 si la colonne ne peut être nulle + </simpara> + </listitem> + <listitem> + <simpara> + type - Type de la colonne + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Exemple avec <function>fbsql_fetch_field</function></title> <programlisting role="php"> <![CDATA[ <?php fbsql_connect($host, $user, $password) - or die ("Impossible de se connecter"); -$result = fbsql_db_query("database", "select * from table;") - or die ("La requête a échoué"); + or die("Impossible de se connecter"); +$result = fbsql_db_query("database", "select * from table") + or die("La requête a échoué"); // lire les données de colonnes $i = 0; while ($i < fbsql_num_fields($result)) { - echo "Information de la colonne $i:<br />\n"; - $meta = fbsql_fetch_field($result); - if (!$meta) { - echo "Aucune information disponible<br />\n"; - } - echo "<pre> - max_length: $meta->max_length - name: $meta->name - not_null: $meta->not_null - table: $meta->table - type: $meta->type - </pre>"; - $i++; + echo "Information de la colonne $i:<br />\n"; + $meta = fbsql_fetch_field($result); + if (!$meta) { + echo "Aucune information disponible<br />\n"; + } + echo "<pre> +max_length: $meta->max_length +name: $meta->name +not_null: $meta->not_null +table: $meta->table +type: $meta->type +</pre>"; + $i++; } fbsql_free_result($result); ?> ]]> </programlisting> </example> - <para> - Voir aussi - <function>fbsql_field_seek</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_field_seek</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -113,4 +145,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-lengths.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/fbsql/functions/fbsql-fetch-lengths.xml diff -u phpdoc-fr/reference/fbsql/functions/fbsql-fetch-lengths.xml:1.9 phpdoc-fr/reference/fbsql/functions/fbsql-fetch-lengths.xml:1.10 --- phpdoc-fr/reference/fbsql/functions/fbsql-fetch-lengths.xml:1.9 Mon Aug 28 12:10:33 2006 +++ phpdoc-fr/reference/fbsql/functions/fbsql-fetch-lengths.xml Tue Jan 23 10:32:00 2007 @@ -1,37 +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-fetch-lengths"> - <refnamediv> - <refname>fbsql_fetch_lengths</refname> - <refpurpose> - Lit la taille de chaque colonne d'un résultat - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>fbsql_fetch_lengths</methodname> - <methodparam><type>resource</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para> - <function>fbsql_fetch_lengths</function> retourne un tableau contenant - les tailles maximales de chaque champ, dans la dernière ligne lue par - <function>fbsql_fetch_row</function> ou &false; en cas d'erreur. - </para> - <para> - <function>fbsql_fetch_lengths</function> stocke les tailles de - chaque ligne de résultat retournée par <function>fbsql_fetch_row</function>, - <function>fbsql_fetch_array</function> et <function>fbsql_fetch_object</function> - dans un tableau à indices numériques, commençant à 0. - </para> - <para> - Voir aussi - <function>fbsql_fetch_row</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fbsql-fetch-lengths"> + <refnamediv> + <refname>fbsql_fetch_lengths</refname> + <refpurpose>Lit la taille de chaque colonne d'un résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>fbsql_fetch_lengths</methodname> + <methodparam><type>resource</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para> + Stocke les tailles de chaque ligne de résultat retournée par + <function>fbsql_fetch_row</function>, + <function>fbsql_fetch_array</function> et + <function>fbsql_fetch_object</function> + dans un tableau à indices numériques, commençant à 0. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &fbsql.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau, commençant à l'offset 0, qui correspond aux tailles + de chaque champs présent dans la dernière ligne récupérée par la + fonction <function>fbsql_fetch_row</function>, ou &false; si une erreur + survient. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>fbsql_fetch_row</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -52,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
« previous php.doc.fr (#5184) next »