dams Tue Jul 31 04:05:48 2001 EDT Modified files: /phpdoc/fr/functions ibase.xml Log: Moved URL to global.ent
Index: phpdoc/fr/functions/ibase.xml diff -u phpdoc/fr/functions/ibase.xml:1.8 phpdoc/fr/functions/ibase.xml:1.9 --- phpdoc/fr/functions/ibase.xml:1.8 Thu Mar 22 05:38:22 2001 +++ phpdoc/fr/functions/ibase.xml Tue Jul 31 04:05:47 2001 @@ -1,92 +1,92 @@ - <reference id="ref.ibase"> - <title>Fonctions InterBase</title> - <titleabbrev>InterBase</titleabbrev> - <partintro> - <para> - Interbase est une base de données populaire, créée - par Borland/Inprise. Pour plus d'informations sur Interbase, allez à - <ulink url="http://www.interbase.com">http://www.interbase.com</ulink>. - Par ailleurs, Interbase vient de rejoindre le mouvement Open Source! +<reference id="ref.ibase"> + <title>InterBase</title> + <titleabbrev>InterBase</titleabbrev> + <partintro> + <para> + Interbase est une base de données populaire, créée + par Borland/Inprise. Pour plus d'informations sur Interbase, allez à + <ulink url="&url.ibase">&url.ibase;</ulink>. + Par ailleurs, Interbase vient de rejoindre le mouvement Open Source! + </para> + <note> + <para> + Le support intégral de InterBase 6 a été ajouté + à PHP 4.0. </para> - <note> - <para> - Le support intégral de InterBase 6 a été ajouté - à PHP 4.0. - </para> - <para> - Cette base de données utilise les guillemets simples (') - pour échapper les caractères, un peu comme le fait Sybase. - Ajoutez à votre fichier <filename>php.ini</filename> la directive - suivante : - <informalexample> - <programlisting> + <para> + Cette base de données utilise les guillemets simples (') + pour échapper les caractères, un peu comme le fait Sybase. + Ajoutez à votre fichier <filename>php.ini</filename> la directive + suivante : + <informalexample> + <programlisting> magic_quotes_sybase = On - </programlisting> - </informalexample> - </para> - </note> - </partintro> - <refentry id="function.ibase-connect"> - <refnamediv> - <refname>ibase_connect</refname> - <refpurpose> - Ouvre une connexion à une base de données Interbase. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource <function>ibase_connect</function></funcdef> - <paramdef>string <parameter>database</parameter></paramdef> - <paramdef>string - <parameter><optional>username</optional></parameter> - </paramdef> - <paramdef>string - <parameter><optional>password</optional></parameter> - </paramdef> - <paramdef>string - <parameter><optional>charset</optional></parameter> - </paramdef> - <paramdef>int - <parameter><optional>buffers</optional></parameter> - </paramdef> - <paramdef>int - <parameter><optional>dialect</optional></parameter> - </paramdef> - <paramdef>string - <parameter><optional>role</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ibase_connect</function> établit une connexin avec - un serveur InterBase. <parameter>database</parameter> doit être un chemin - valide jusqu'à un fichier de base de donnés sur le serveur sur - lequel il résde. Si le serveur est distant, il faut le préfixer - avec un nom d'hôte 'hostname:' (TCP/IP), '//hostname/' (NetBEUI) ou - 'hostname@' (IPX/SPX), en fonction du protocole de communication utilisé. - <parameter>username</parameter> et <parameter>password</parameter> peuvent - être spécifié dans les directives de configuration du PHP - ibase.default_user et ibase.default_password. <parameter>charset</parameter> est - le jeu de caractère par défaut de la base. - <parameter>buffers</parameter> est le nombre de buffer de base à - allouer pour le cache serveur. Si il est passé à 0 ou - omis, le serveur choisira de lui-même. <parameter>dialect</parameter> - selectionne le dialecte SQL pour les requêtes exécutées - avec cette connexion, et par défaut, il utilise le meilleur dialecte - disponible. - </para> - <para> - Si un deuxième appel est fait avec <function>ibase_connect</function>, en - passant les mêmes arguments, une nouvelle connexion ne sera pas ouverte, - mais la connexion déjà ouverte sera retournée. La connexion - sera fermée dès que le script se termine, à moins qu'elle - ne soit fermée explicitement avec <function>ibase_close</function>, - durant le script. - <example> - <title>Exemple <function>ibase_connect</function></title> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + </note> + </partintro> + <refentry id="function.ibase-connect"> + <refnamediv> + <refname>ibase_connect</refname> + <refpurpose> + Ouvre une connexion à une base de données Interbase. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>ibase_connect</function></funcdef> + <paramdef>string <parameter>database</parameter></paramdef> + <paramdef>string + <parameter><optional>username</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>password</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>charset</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>buffers</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>dialect</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>role</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_connect</function> établit une connexin avec + un serveur InterBase. <parameter>database</parameter> doit être un chemin + valide jusqu'à un fichier de base de donnés sur le serveur sur + lequel il résde. Si le serveur est distant, il faut le préfixer + avec un nom d'hôte 'hostname:' (TCP/IP), '//hostname/' (NetBEUI) ou + 'hostname@' (IPX/SPX), en fonction du protocole de communication +utilisé. + <parameter>username</parameter> et <parameter>password</parameter> peuvent + être spécifié dans les directives de configuration du PHP + ibase.default_user et ibase.default_password. <parameter>charset</parameter> est + le jeu de caractère par défaut de la base. + <parameter>buffers</parameter> est le nombre de buffer de base à + allouer pour le cache serveur. S'il est passé à 0 ou + omis, le serveur choisira de lui-même. <parameter>dialect</parameter> + sélectionne le dialecte SQL pour les requêtes exécutées + avec cette connexion, et par défaut, il utilise le meilleur dialecte + disponible. + </para> + <para> + Si un deuxième appel est fait avec <function>ibase_connect</function>, en + passant les mêmes arguments, une nouvelle connexion ne sera pas ouverte, + mais la connexion déjà ouverte sera retournée. La connexion + sera fermée dès que le script se termine, à moins qu'elle + ne soit fermée explicitement avec <function>ibase_close</function>, + durant le script. + <example> + <title>Exemple <function>ibase_connect</function></title> + <programlisting role="php"> <?php $dbh = ibase_connect($host, $username, $password); $stmt = 'SELECT * FROM tblname'; @@ -96,213 +96,215 @@ } ibase_close($dbh); ?> - </programlisting> - </example> + </programlisting> + </example> + </para> + <note> + <para> + <parameter>buffers</parameter> a été ajouté en PHP 4-RC2. </para> - <note> - <para> - <parameter>buffers</parameter> a été ajouté dans PHP4-RC2. - </para> - </note> - <note> - <para> - <parameter>dialect</parameter> a été ajouté dans PHP4-RC2. - Il n'est opérationnel qu'avec les versions InterBase 6 et plus - récentes. - </para> - </note> - <note> - <para> - <parameter>role</parameter> a été ajouté dans PHP4-RC2. - Il n'est opérationnel qu'avec les versions InterBase 5 et plus - récentes. - </para> - </note> + </note> + <note> <para> - Voir aussi: <function>ibase_pconnect</function>. + <parameter>dialect</parameter> a été ajouté en PHP 4-RC2. + Il n'est opérationnel qu'avec les versions InterBase 6 et plus + récentes. </para> - </refsect1> - </refentry> - <refentry id="function.ibase-pconnect"> - <refnamediv> - <refname>ibase_pconnect</refname> - <refpurpose> - Ouvre une connexion persistante à une base de données Interbase. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource <function>ibase_pconnect</function></funcdef> - <paramdef>string <parameter>database</parameter></paramdef> - <paramdef>string - <parameter><optional>username</optional></parameter> - </paramdef> - <paramdef>string - <parameter><optional>password</optional></parameter> - </paramdef> - <paramdef>string - <parameter><optional>charset</optional></parameter> - </paramdef> - <paramdef>int - <parameter><optional>buffers</optional></parameter> - </paramdef> - <paramdef>int - <parameter><optional>dialect</optional></parameter> - </paramdef> - <paramdef>string - <parameter><optional>role</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> + </note> + <note> <para> - <function>ibase_pconnect</function> se comporte similairement à - <function>ibase_connect</function>, avec deux différences - majeures : la première est que, lors de la connexion, la fonction - va essayer de trouver une connexion (perisitante) déjà ouverte. - Si elle la trouve, cette dernière sera retournée, plutôt - qu'une nouvelle connexion. Sinon, une nouvelle connexion sera ouverte. - La deuxième est que la connexion ne sera pas fermée à la fin - du script, mais restera ouverte pour utilisation ultérieure. - (<function>ibase_close</function> ne fermera pas une connexion ouverte - avec <function>ibase_pconnect</function>). Ce type de lien est alors dit - 'persistant'. + <parameter>role</parameter> a été ajouté en PHP 4-RC2. + Il n'est opérationnel qu'avec les versions InterBase 5 et plus + récentes. </para> - <note> - <para> - <parameter>buffers</parameter> a été ajouté dans PHP4-RC2. - </para> - </note> - <note> - <para> - <parameter>dialect</parameter> a été ajouté dans PHP4-RC2. - Il n'est opérationnel qu'avec les versions InterBase 6 et plus - récentes. - </para> - </note> - <note> - <para> - <parameter>role</parameter> a été ajouté dans PHP4-RC2. - Il n'est opérationnel qu'avec les versions InterBase 5 et plus - récentes. - </para> - </note> + </note> + <para> + Voir aussi + <function>ibase_pconnect</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ibase-pconnect"> + <refnamediv> + <refname>ibase_pconnect</refname> + <refpurpose> + Ouvre une connexion persistante à une base de données Interbase. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>ibase_pconnect</function></funcdef> + <paramdef>string <parameter>database</parameter></paramdef> + <paramdef>string + <parameter><optional>username</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>password</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>charset</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>buffers</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>dialect</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>role</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_pconnect</function> se comporte similairement à + <function>ibase_connect</function>, avec deux différences + majeures : la première est que, lors de la connexion, la fonction + va essayer de trouver une connexion (peristante) déjà ouverte. + Si elle la trouve, cette dernière sera retournée, plutôt + qu'une nouvelle connexion. Sinon, une nouvelle connexion sera ouverte. + La deuxième est que la connexion ne sera pas fermée à la fin + du script, mais restera ouverte pour utilisation ultérieure. + (<function>ibase_close</function> ne fermera pas une connexion ouverte + avec <function>ibase_pconnect</function>). Ce type de lien est alors dit + 'persistant'. + </para> + <note> <para> - Voir aussi <function>ibase_connect</function> pour plus de détails - sur les arguments de cette fonction. + <parameter>buffers</parameter> a été ajouté en PHP 4-RC2. </para> - </refsect1> - </refentry> - <refentry id="function.ibase-close"> - <refnamediv> - <refname>ibase_close</refname> - <refpurpose> - Ferme une connexion à une base de données Interbase. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ibase_close</function></funcdef> - <paramdef>resource - <parameter><optional>connection_id</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> + </note> + <note> + <para> + <parameter>dialect</parameter> a été ajouté en PHP 4-RC2. + Il n'est opérationnel qu'avec les versions InterBase 6 et plus + récentes. + </para> + </note> + <note> <para> - <function>ibase_close</function> ferme une connexion à une base - de données Interbase. Cette fonction prend comme argument l'identifiant - de connexion <parameter>connection_id</parameter> retourné par - <function>ibase_connect</function>. Si <parameter>connection_id</parameter> - est omis, la dernière connexion ibase est fermée. Les - transactions par défaut sont validées et les autres sont - annulées. + <parameter>role</parameter> a été ajouté en PHP 4-RC2. + Il n'est opérationnel qu'avec les versions InterBase 5 et plus + récentes. </para> - </refsect1> - </refentry> - <refentry id="function.ibase-query"> - <refnamediv> - <refname>ibase_query</refname> - <refpurpose>Exécute une requête sur une base Interbase</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource <function>ibase_query</function></funcdef> - <paramdef>resource - <parameter><optional>link_identifier</optional></parameter> - </paramdef> - <paramdef>string - <parameter>query</parameter> - </paramdef> - <paramdef>int - <parameter><optional>bind_args</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>ibase_query</function> exécute une requête sur - une base Interbase, et retourne un identifiant de résultat, - à utiliser avec <function>ibase_fetch_row</function>, - <function>ibase_free_result</function> et/ou <function>ibase_free_query</function>. - </simpara> - <note> - <para> - Bien que ces fonctions supportent la liaison de variables avec des - paramètres de requêtes, il n'y a pas d'interêt spécial - à les utiliser. Pour des exemples grandeur réelle, voyez - <function>ibase_prepare</function> et <function>ibase_execute</function>. - </para> - </note> - </refsect1> - </refentry> - <refentry id="function.ibase-fetch-row"> - <refnamediv> - <refname>ibase_fetch_row</refname> - <refpurpose> Lit une ligne dans une base Interbase</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>ibase_fetch_row</function></funcdef> - <paramdef>resource - <parameter>result_identifier</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>ibase_fetch_row</function> retourne la prochaîne - ligne spécifiée dans le résultat obtenu de - <function>ibase_query</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.ibase-fetch-object"> - <refnamediv> - <refname>ibase_fetch_object</refname> - <refpurpose>Lit une ligne dans une base Interbase dans un objet.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>ibase_fetch_object</function></funcdef> - <paramdef>resource - <parameter>result_id</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> + </note> + <para> + Voir aussi + <function>ibase_connect</function> pour plus de détails + sur les arguments de cette fonction. + </para> + </refsect1> + </refentry> + <refentry id="function.ibase-close"> + <refnamediv> + <refname>ibase_close</refname> + <refpurpose> + Ferme une connexion à une base de données Interbase. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_close</function></funcdef> + <paramdef>resource + <parameter><optional>connection_id</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_close</function> ferme une connexion à une base + de données Interbase. Cette fonction prend comme argument l'identifiant + de connexion <parameter>connection_id</parameter> retourné par + <function>ibase_connect</function>. Si <parameter>connection_id</parameter> + est omis, la dernière connexion ibase est fermée. Les + transactions par défaut sont validées et les autres sont + annulées. + </para> + </refsect1> + </refentry> + <refentry id="function.ibase-query"> + <refnamediv> + <refname>ibase_query</refname> + <refpurpose>Exécute une requête sur une base Interbase</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>ibase_query</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + <paramdef>string + <parameter>query</parameter> + </paramdef> + <paramdef>int + <parameter><optional>bind_args</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>ibase_query</function> exécute une requête sur + une base Interbase, et retourne un identifiant de résultat, + à utiliser avec <function>ibase_fetch_row</function>, + <function>ibase_free_result</function> et/ou +<function>ibase_free_query</function>. + </simpara> + <note> <para> - <function>ibase_fetch_object</function> lit une ligne dans une base - Interbase et la place dans un pseudo objet. <function>ibase_fetch_object</function> - prend comme argument l'identifiant de résultat <parameter>result_id</parameter> - obtenu de <function>ibase_query</function> ou <function>ibase_execute</function>. - <informalexample> - <programlisting role="php"> + Bien que ces fonctions supportent la liaison de variables avec des + paramètres de requêtes, il n'y a pas d'intérêt +spécial + à les utiliser. Pour des exemples grandeur réelle, voyez + <function>ibase_prepare</function> et <function>ibase_execute</function>. + </para> + </note> + </refsect1> + </refentry> + <refentry id="function.ibase-fetch-row"> + <refnamediv> + <refname>ibase_fetch_row</refname> + <refpurpose> Lit une ligne dans une base Interbase</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>ibase_fetch_row</function></funcdef> + <paramdef>resource + <parameter>result_identifier</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>ibase_fetch_row</function> retourne la prochaine + ligne spécifiée dans le résultat obtenu de + <function>ibase_query</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ibase-fetch-object"> + <refnamediv> + <refname>ibase_fetch_object</refname> + <refpurpose>Lit une ligne dans une base Interbase dans un objet.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>ibase_fetch_object</function></funcdef> + <paramdef>resource + <parameter>result_id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_fetch_object</function> lit une ligne dans une base + Interbase et la place dans un pseudo objet. +<function>ibase_fetch_object</function> + prend comme argument l'identifiant de résultat +<parameter>result_id</parameter> + obtenu de <function>ibase_query</function> ou <function>ibase_execute</function>. + <informalexample> + <programlisting role="php"> <php $dbh = ibase_connect($host, $username, $password); $stmt = 'SELECT * FROM tblname'; @@ -311,40 +313,42 @@ print $row->email . "\n"; } ibase_close($dbh); -?gt; - </programlisting> - </informalexample> - </para> - <para> - Voir aussi - <function>ibase_fetch_row</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.ibase-field-info"> - <refnamediv> - <refname>ibase_field_info</refname> - <refpurpose> - Lit les informations sur un champs - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>ibase_field_info</function></funcdef> - <paramdef>resource <parameter>result</parameter></paramdef> - <paramdef>int <parameter>field number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ibase_field_info</function> retourne un tableau - contenant les informations sur un champs après une - requête de SELECT. Le tableau contient les index - name (nom), alias, relation, length (taille), type. - </para> - <informalexample> - <programlisting role="php"> +?> + </programlisting> + </informalexample> + </para> + <para> + Voir aussi + <function>ibase_fetch_row</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ibase-field-info"> + <refnamediv> + <refname>ibase_field_info</refname> + <refpurpose> + Lit les informations sur un champs + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>ibase_field_info</function></funcdef> + <paramdef>resource <parameter>result</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_field_info</function> retourne un tableau + contenant les informations sur le champs numéro + <parameter>field_number</parameter> après une + requête de SELECT. Le tableau contient les index + name (nom), alias, relation, length (taille), type. + </para> + <informalexample> + <programlisting role="php"> +<?php // [EMAIL PROTECTED] 08-Dec-2000 02:53 $rs=ibase_query("Select * from unetable"); $coln = ibase_num_fields($rs); @@ -356,83 +360,84 @@ echo "taille: ".$col_info['length']."\n"; echo "type: ".$col_info['type']."\n"; } - </programlisting> - </informalexample> - </refsect1> - </refentry> - <refentry id="function.ibase-free-result"> - <refnamediv> - <refname>ibase_free_result</refname> - <refpurpose>Libère un résultat.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ibase_free_result</function></funcdef> - <paramdef>resource - <parameter>result_identifier</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>ibase_free_result</function> libère les ressources - liées au résultat <parameter>result_identifier</parameter>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.ibase-prepare"> - <refnamediv> - <refname>ibase_prepare</refname> - <refpurpose> - Prépare une requête pour lier les paramètres et - l'éxécuter ultérieurement. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ibase_prepare</function></funcdef> - <paramdef>resource - <parameter><optional>link_identifier</optional></parameter> - </paramdef> - <paramdef>string <parameter>query</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>ibase_prepare</function> prépare une - requête pour l'éxécuter - </simpara> - </refsect1> - </refentry> - <refentry id="function.ibase-execute"> - <refnamediv> - <refname>ibase_execute</refname> - <refpurpose>Exécute une requête préparée.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource <function>ibase_execute</function></funcdef> - <paramdef>int - <parameter>query</parameter> - </paramdef> - <paramdef>int - <parameter><optional>bind_args</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ibase_execute</function> exécute une requête - préparée (et éventuellement liée) par - <function>ibase_prepare</function>. <function>ibase_execute</function> - est beaucoup plus efficace que <function>ibase_query</function>, si - vous effectuez plusieurs fois la même requête, en ne - changeant que quelques paramètres. +?> + </programlisting> + </informalexample> + </refsect1> + </refentry> + <refentry id="function.ibase-free-result"> + <refnamediv> + <refname>ibase_free_result</refname> + <refpurpose>Libère un résultat.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_free_result</function></funcdef> + <paramdef>resource + <parameter>result_identifier</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>ibase_free_result</function> libère les ressources + liées au résultat <parameter>result_identifier</parameter>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ibase-prepare"> + <refnamediv> + <refname>ibase_prepare</refname> + <refpurpose> + Prépare une requête pour lier les paramètres et + l'éxécuter ultérieurement. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_prepare</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>ibase_prepare</function> prépare une + requête pour l'éxécuter + </simpara> + </refsect1> + </refentry> + <refentry id="function.ibase-execute"> + <refnamediv> + <refname>ibase_execute</refname> + <refpurpose>Exécute une requête préparée.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>ibase_execute</function></funcdef> + <paramdef>int + <parameter>query</parameter> + </paramdef> + <paramdef>int + <parameter><optional>bind_args</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_execute</function> exécute une requête + préparée (et éventuellement liée) par + <function>ibase_prepare</function>. <function>ibase_execute</function> + est beaucoup plus efficace que <function>ibase_query</function>, si + vous effectuez plusieurs fois la même requête, en ne + changeant que quelques paramètres. <informalexample> - <programlisting role="php"> + <programlisting role="php"> <?php $updates = array( 1 => 'Eric', @@ -444,231 +449,231 @@ ibase_execute($query, $bar, $baz); } ?> - </programlisting> - </informalexample> - </para> - </refsect1> - </refentry> + </programlisting> + </informalexample> + </para> + </refsect1> + </refentry> <refentry id="function.ibase-trans"> - <refnamediv> - <refname>ibase_trans</refname> - <refpurpose>Prépare une transaction</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource <function>ibase_trans</function></funcdef> - <paramdef>int - <parameter><optional>trans_args</optional></parameter> - </paramdef> - <paramdef>resource - <parameter><optional>link_identifier</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ibase_trans</function> prépare une transaction - </para> - </refsect1> - </refentry> - <refentry id="function.ibase-commit"> - <refnamediv> - <refname>ibase_commit</refname> - <refpurpose>Valide une transaction</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ibase_commit</function></funcdef> - <paramdef>resource - <parameter><optional>link_identifier</optional></parameter> - </paramdef> - <paramdef>resource <parameter>trans_number</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ibase_commit</function> valide la transaction - <parameter>trans_number</parameter>, qui a été - préparée avec <function>ibase_trans</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.ibase-rollback"> - <refnamediv> - <refname>ibase_rollback</refname> - <refpurpose>Annule une transaction</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ibase_rollback</function></funcdef> - <paramdef>resource - <parameter><optional>link_identifier</optional></parameter> - </paramdef> - <paramdef>resource <parameter>trans_number</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ibase_rollback</function> annule la transaction - <parameter>trans_number</parameter> qui a été - préparée avec <function>ibase_trans</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.ibase-free-query"> - <refnamediv> - <refname>ibase_free_query</refname> - <refpurpose> - Libère la mémoire reservée par une requête - préparée. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ibase_free_query</function></funcdef> - <paramdef>resource <parameter>query</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>ibase_free_query</function> libère la mémoire - réservée par une requête préparée - par <function>ibase_prepare</function>. - </simpara> - </refsect1> - </refentry> - <refentry id="function.ibase-timefmt"> - <refnamediv> - <refname>ibase_timefmt</refname> - <refpurpose> - Fixe le format de date pour les prochaînes requêtes. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ibase_timefmt</function></funcdef> - <paramdef>string - <parameter>format</parameter> - </paramdef> - <paramdef>int - <parameter><optional>columntype</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ibase_timefmt</function> fixe le format des colonnes de - type dates, heure et timestamp, retournées par les requêtes. - En interne, les colonnes sont formatées par la fonction C - strftime() : reportez-vous à sa documentation pour - connaître la structure de la chaîne de format. - <parameter>columntype</parameter> est une des constantes suivantes : - IBASE_TIMESTAMP, IBASE_DATE ou IBASE_TIME. - Si elle est omise, la valeur par défaut est IBASE_TIMESTAMP, - pour compatibilité ascendante. - <informalexample> - <programlisting role="php"> + <refnamediv> + <refname>ibase_trans</refname> + <refpurpose>Prépare une transaction</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>ibase_trans</function></funcdef> + <paramdef>int + <parameter><optional>trans_args</optional></parameter> + </paramdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_trans</function> prépare une transaction + </para> + </refsect1> + </refentry> + <refentry id="function.ibase-commit"> + <refnamediv> + <refname>ibase_commit</refname> + <refpurpose>Valide une transaction</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_commit</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + <paramdef>resource <parameter>trans_number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_commit</function> valide la transaction + <parameter>trans_number</parameter>, qui a été + préparée avec <function>ibase_trans</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ibase-rollback"> + <refnamediv> + <refname>ibase_rollback</refname> + <refpurpose>Annule une transaction</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_rollback</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + <paramdef>resource <parameter>trans_number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_rollback</function> annule la transaction + <parameter>trans_number</parameter> qui a été + préparée avec <function>ibase_trans</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.ibase-free-query"> + <refnamediv> + <refname>ibase_free_query</refname> + <refpurpose> + Libère la mémoire réservée par une requête + préparée. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_free_query</function></funcdef> + <paramdef>resource <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>ibase_free_query</function> libère la mémoire + réservée par une requête préparée + par <function>ibase_prepare</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.ibase-timefmt"> + <refnamediv> + <refname>ibase_timefmt</refname> + <refpurpose> + Fixe le format de date pour les prochaines requêtes. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_timefmt</function></funcdef> + <paramdef>string + <parameter>format</parameter> + </paramdef> + <paramdef>int + <parameter><optional>columntype</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_timefmt</function> fixe le format des colonnes de + type dates, heure et timestamp, retournées par les requêtes. + En interne, les colonnes sont formatées par la fonction C + strftime() : reportez-vous à sa documentation pour + connaître la structure de la chaîne de format. + <parameter>columntype</parameter> est une des constantes suivantes : + IBASE_TIMESTAMP, IBASE_DATE ou IBASE_TIME. + Si elle est omise, la valeur par défaut est IBASE_TIMESTAMP, + pour compatibilité ascendante. + <informalexample> + <programlisting role="php"> <?php // Les colonnes TIME de InterBase 6 seront retournées avec // la forme '05 heures 37 minutes'. ibase_timefmt("%H heures %M minutes", IBASE_TIME); ?> - </programlisting> - </informalexample> - </para> + </programlisting> + </informalexample> + </para> + <para> + Vous pouvez aussi modifier les formats par défaut avec les directives + PHP ibase.timestampformat, ibase.dateformat et ibase.timeformat. + </para> + <note> <para> - Vous pouvez aussi modifier les formats par défaut avec les directives - PHP ibase.timestampformat, ibase.dateformat et ibase.timeformat. + <parameter>columntype</parameter> a été ajouté en PHP 4.0. + Il n'a aucun sens jusqu'à InterBase version 6 et plus récent. </para> - <note> - <para> - <parameter>columntype</parameter> a été ajouté dans PHP 4.0. Il n'a - aucun sens jusqu'à InterBase version 6 et plus récent. - </para> - </note> - <note> - <para> - Une modification incompatible avec l'existant est apparue - dans PHP 4.0 lorsque la directive PHP ibase.timeformat a été renommée - ibase.timestampformat et les directives ibase.dateformat et - ibase.timeformat ont été ajoutée, de manière à les adapter à leur - fonction. - </para> - </note> - </refsect1> - </refentry> - <refentry id="function.ibase-num-fields"> - <refnamediv> - <refname>ibase_num_fields</refname> - <refpurpose> - Retourne le nombre de lignes dans un résultat. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ibase_num_fields</function></funcdef> - <paramdef>resource <parameter>result_id</parameter></paramdef> - </funcprototype> - </funcsynopsis> + </note> + <note> <para> - <function>ibase_num_fields</function>< retourne le nombre - de lignes dans un résultat. - <informalexample> - <programlisting role="php"> + Une modification incompatible avec l'existant est apparue + en PHP 4.0 lorsque la directive PHP ibase.timeformat a été + renommée en ibase.timestampformat et les directives ibase.dateformat et + ibase.timeformat ont été ajoutée, de manière + à les adapter à leur fonction. + </para> + </note> + </refsect1> + </refentry> + <refentry id="function.ibase-num-fields"> + <refnamediv> + <refname>ibase_num_fields</refname> + <refpurpose> + Retourne le nombre de colonnes dans un résultat. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ibase_num_fields</function></funcdef> + <paramdef>resource <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ibase_num_fields</function> retourne le nombre + de colonnes dans un résultat. + <informalexample> + <programlisting role="php"> <?php -$dbh = ibase_connect($host, $username, $password); -$stmt = 'SELECT * FROM tblname'; -$sth = ibase_query($dbh, $stmt); -if ( ibase_num_rows($sth) > 0 ) { - while ($row = ibase_fetch_object($sth)) { - print $row->email . "\n"; + $dbh = ibase_connect ($host, $username, $password); + $stmt = 'SELECT * FROM tblname'; + $sth = ibase_query($dbh, $stmt); + if (ibase_num_fields($sth) > 0) { + while ($row = ibase_fetch_object ($sth)) { + print $row->email . "\n"; + } + } else { + die ("Aucun résultat dans votre requête"); } -} else { - die("Aucun résultat"); -} -ibase_close($dbh); + ibase_close ($dbh); ?> - </programlisting> - </informalexample> + </programlisting> + </informalexample> + </para> + <note> + <para> + <function>ibase_timefmt</function> ne fonctionne pas encore sous PHP4. </para> - <note> - <para> - <function>ibase_timefmt</function> ne fonctionne pas encore sous PHP4. - </para> - </note> - </refsect1> - </refentry> - <refentry id="function.ibase-errmsg"> - <refnamediv> - <refname>ibase_errmsg</refname> - <refpurpose> - Retourne un message d'erreur - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>ibase_errmsg</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>ibase_errmsg</function> retourne une chaîne - contenant les messages d'erreurs. - </simpara> - </refsect1> - </refentry> - </reference> + </note> + </refsect1> + </refentry> + <refentry id="function.ibase-errmsg"> + <refnamediv> + <refname>ibase_errmsg</refname> + <refpurpose> + Retourne un message d'erreur + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>ibase_errmsg</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>ibase_errmsg</function> retourne une chaîne + contenant les messages d'erreurs. + </simpara> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml