cvs: phpdoc /fr/functions uodbc.xml
| From: | Damien Seguy | Date: | Thu, 12 Jul 2001 12:16:18 +0000 |
| Subject: | cvs: phpdoc /fr/functions uodbc.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336202@lists.php.net to get a copy of this message | ||
dams Thu Jul 12 08:16:18 2001 EDT
Modified files:
/phpdoc/fr/functions uodbc.xml
Log:
Correcting errors for Jade/docbook
Index: phpdoc/fr/functions/uodbc.xml diff -u phpdoc/fr/functions/uodbc.xml:1.11 phpdoc/fr/functions/uodbc.xml:1.12 --- phpdoc/fr/functions/uodbc.xml:1.11 Sat Jul 7 18:22:27 2001 +++ phpdoc/fr/functions/uodbc.xml Thu Jul 12 08:16:17 2001 @@ -19,7 +19,7 @@ <ulink url="&url.sybase;">Sybase SQL Anywhere</ulink>. </simpara> <simpara> - Reportez vous à + Reportez-vous à <link linkend="install.configure.databases">Installation sous Unix</link> pour plus de détails sur les configurations de ces serveurs. </simpara> @@ -29,7 +29,7 @@ données ci-dessus. Les fonctions que vous utiliserez portent des noms évocateurs, et utilisent les mêmes syntaxes que leurs cousines d'ODBC. L'exception à ceci est iODBC. En compilant PHP avec le - suppport iODBC, vous pourrez utiliser n'importe quel pilote + support iODBC, vous pourrez utiliser n'importe quel pilote compatible ODBC avec vos applications PHP. iODBC est mis à jour à <ulink url="&url.openlink;">OpenLink Software</ulink>. Plus d'informations sur iODBC, ainsi qu'un HOWTO (en anglais), est disponible à @@ -40,7 +40,7 @@ <refentry id="function.odbc-autocommit"> <refnamediv> <refname>odbc_autocommit</refname> - <refpurpose>Mode auto-validation</refpurpose> + <refpurpose>Active le mode auto-validation</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -54,15 +54,15 @@ <para> Sans le paramètre <parameter>OnOff</parameter>, <function>odbc_autocommit</function> retourne le statut d'auto-validation - de la connexion <parameter>connection_id</parameter>. &true; - si le mode est activé, &false; si il ne l'est pas, + de la connexion <parameter>connection_id</parameter>. <literal>TRUE</literal> + si le mode est activé, <literal>FALSE</literal> s'il ne l'est pas, ou si une erreur survient. </para> <para> - Si <parameter>OnOff</parameter> vaut &true;, l'auto-validation - est activée. Si il est &false;, l'auto-validation + Si <parameter>OnOff</parameter> vaut <literal>TRUE</literal>, l'auto-validation + est activée. S'il est <literal>FALSE</literal>, l'auto-validation est désactivée. <function>odbc_autocommit</function> retourne - &true; en cas de succès, &false; + <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal> en cas d'échec. </para> <para> @@ -80,7 +80,7 @@ <refentry id="function.odbc-binmode"> <refnamediv> <refname>odbc_binmode</refname> - <refpurpose>Gestion des colonnes de données binaires.</refpurpose> + <refpurpose>Modifie la gestion des colonnes de données binaires.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -122,48 +122,48 @@ <title>Conversion des LONGVARBINARY </title> <tgroup cols="3"> <thead> - <row> - <entry>mode</entry> - <entry>longueur</entry> - <entry>résultat</entry> - </row> + <row> + <entry>mode</entry> + <entry>longueur</entry> + <entry>résultat</entry> + </row> </thead> <tbody> - <row> - <entry>ODBC_BINMODE_PASSTHRU</entry> - <entry>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_RETURN</entry> - <entry>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_CONVERT</entry> - <entry>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_PASSTHRU</entry> - <entry>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_PASSTHRU</entry> - <entry>>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_RETURN</entry> - <entry>>0</entry> - <entry>Tel quel</entry> - </row> - <row> - <entry>ODBC_BINMODE_CONVERT</entry> - <entry>>0</entry> - <entry>Caractère</entry> - </row> + <row> + <entry>ODBC_BINMODE_PASSTHRU</entry> + <entry>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_RETURN</entry> + <entry>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_CONVERT</entry> + <entry>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_PASSTHRU</entry> + <entry>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_PASSTHRU</entry> + <entry>>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_RETURN</entry> + <entry>>0</entry> + <entry>Tel quel</entry> + </row> + <row> + <entry>ODBC_BINMODE_CONVERT</entry> + <entry>>0</entry> + <entry>Caractère</entry> + </row> </tbody> </tgroup> </table> @@ -180,7 +180,7 @@ La valeur par défaut de <literal>4096</literal> est 4096 et les valeurs par défaut de odbc_binmode est <literal>ODBC_BINMODE_RETURN</literal>. La gestion des colonnes - binaires est aussi modifié par <function>odbc_longreadlen</function>. + binaires est aussi modifiée par <function>odbc_longreadlen</function>. </simpara> </note> </para> @@ -205,7 +205,7 @@ l'identifiant de connexion <parameter>connection_id</parameter>. <note> <simpara> - <function>odbc_close</function> échouera si il y a des + <function>odbc_close</function> échouera s'il y a des transactions en cours sur cette connexion. Dans ce cas, la connexion restera ouverte. </simpara> @@ -231,7 +231,7 @@ ODBC à des sources de données. <note> <simpara> - <function>odbc_close_all</function> échouera si il y a des + <function>odbc_close_all</function> échouera s'il y a des transactions en cours sur cette connexion. Dans ce cas, la connexion restera ouverte. </simpara> @@ -253,8 +253,8 @@ </funcprototype> </funcsynopsis> <para> - <function>odbc_commit</function> retourne &true; en - cas de succès, &false; en cas d'erreur. Toutes + <function>odbc_commit</function> retourne <literal>TRUE</literal> en + cas de succès, <literal>FALSE</literal> en cas d'erreur. Toutes les connexions en cours sur <parameter>connection_id</parameter> sont validées. </para> @@ -278,7 +278,7 @@ </funcsynopsis> <para> <function>odbc_connect</function> retourne un identifiant de connexion ODBC - ou 0 (&false;) en cas d'erreur. + ou 0 (<literal>FALSE</literal>) en cas d'erreur. </para> <simpara> L'identifiant de connexion retournée par cette fonction est @@ -295,7 +295,7 @@ "Cannot open a cursor on a stored procedure that has anything other than a single select statement in it", ce qui signifie : "Impossible de créer un pointeur de résultat dans une procédure - enregistrée qui est réduite à une simple selection + enregistrée qui est réduite à une simple sélection (SELECT)). Utiliser l'option SQL_CUR_USE_ODBC permet d'éviter cette erreur. De plus, certains pilotes ne supportent le paramètre optionnel de numéro de ligne dans <function>odbc_fetch_row</function>. @@ -308,27 +308,27 @@ <itemizedlist> <listitem> <simpara> - SQL_CUR_USE_IF_NEEDED + SQL_CUR_USE_IF_NEEDED </simpara> </listitem> <listitem> <simpara> - SQL_CUR_USE_ODBC + SQL_CUR_USE_ODBC </simpara> </listitem> <listitem> <simpara> - SQL_CUR_USE_DRIVER + SQL_CUR_USE_DRIVER </simpara> </listitem> <listitem> <simpara> - SQL_CUR_DEFAULT + SQL_CUR_DEFAULT </simpara></listitem> </itemizedlist> </para> <simpara> - Pour les connexions persistantes, reportez vous à + Pour les connexions persistantes, reportez-vous à <function>odbc_pconnect</function>. </simpara> </refsect1> @@ -367,7 +367,7 @@ </funcprototype> </funcsynopsis> <para> - <function>odbc_do</function> excécute la requête + <function>odbc_do</function> exécute la requête <parameter>query</parameter> avec la connexion <parameter>connection_id</parameter>. </para> </refsect1> @@ -395,7 +395,7 @@ </simpara> <simpara> Voir aussi - <function>odbc_errormsg</function> et + <function>odbc_errormsg</function> et <function>odbc_exec</function>. </simpara> </refsect1> @@ -445,7 +445,7 @@ </funcprototype> </funcsynopsis> <para> - <function>odbc_exec</function> retourne &false; + <function>odbc_exec</function> retourne <literal>FALSE</literal> en cas d'erreur, ou bien retourne un identifiant de résultat ODBC en cas d'exécution réussie. </para> @@ -472,20 +472,22 @@ </refnamediv> <refsect1> <title>Description</title> - <funcsynopsis> + <funcsynopsis> + <funcprototype> <funcdef>int <function>odbc_execute</function></funcdef> <paramdef>resource <parameter>result_id</parameter></paramdef> <paramdef>array <parameter><optional>parameters_array</optional></parameter></paramdef> - </funcsynopsis> + </funcprototype> + </funcsynopsis> <para> <function>odbc_execute</function> exécute une requête SQL préparée par <function>odbc_prepare</function>. - <function>odbc_execute</function> retourne &true; - en cas d'exécution réussie, et &false; + <function>odbc_execute</function> retourne <literal>TRUE</literal> + en cas d'exécution réussie, et <literal>FALSE</literal> sinon. Le tableau de paramètres <parameter>parameters_array</parameter> ne sert que si vous avez - besoin de paramètres votre requête. + besoin de paramètrer votre requête. </para> </refsect1> </refentry> @@ -493,7 +495,7 @@ <refnamediv> <refname>odbc_fetch_into</refname> <refpurpose> - Lit une ligne de résultat, et la place dans un tableau. + Lit une ligne de résultat, et la place dans un tableau. </refpurpose> </refnamediv> <refsect1> @@ -508,13 +510,73 @@ </funcsynopsis> <para> <function>odbc_fetch_into</function> retourne le nombre de colonnes - dans le résultat, ou &false; en cas d'erreur. + dans le résultat, ou <literal>FALSE</literal> en cas d'erreur. <parameter>result_array</parameter> doit avoir été passé par référence, mais il peut être de n'importe quel type, étant donné qu'il sera converti en tableau. Le tableau contiendra les valeurs des colonnes, ces dernières étant numérotées à partir de 0. </para> + <para> + <example> + <title>Exemple avec <function>odbc_fetch_into</function> (avant PHP 4.0.6)</title> + <programlisting role="php"> +<?php + $rc = odbc_fetch_into($res_id, $my_array); +?> + </programlisting> + </example> + ou + <informalexample> + <programlisting role="php"> +<?php + $rc = odbc_fetch_into($res_id, $row, $my_array); + $rc = odbc_fetch_into($res_id, 1, $my_array); +?> + </programlisting> + </informalexample> + </para> + <para> + Jusqu'en PHP 4.0.5, le paramètre <parameter>result_array</parameter> n'a plus + besoin d'être passé par référence. + </para> + <para> + Depuis PHP 4.0.6, le paramètre <parameter>rownumber</parameter> ne peut pas + être passé comme une constante, mais comme une variable. + </para> + <para> + <example> + <title>Exemple avec <function>odbc_fetch_into</function> (après PHP 4.0.6)</title> + <programlisting role="php"> +<?php + $rc = odbc_fetch_into($res_id, $my_array); +?> + </programlisting> + </example> + ou + <informalexample> + <programlisting role="php"> +<?php + $row = 1; + $rc = odbc_fetch_into($res_id, $row, $my_array); +?> + </programlisting> + </informalexample> + </para> + <para> + Evolution ultérieure : en PHP 4.1, <function>odbc_fetch_into</function> + aura le format suivant : + <funcsynopsis> + <funcprototype> + <funcdef>int <function>odbc_fetch_into</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>array <parameter>result_array</parameter></paramdef> + <paramdef>int <parameter><optional>rownumber</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + Notez que le paramètre <parameter>rownumber</parameter> sera optionnel, tandis que + <parameter>result_array</parameter> ne l'est pas. + </para> </refsect1> </refentry> <refentry id="function.odbc-fetch-row"> @@ -532,9 +594,9 @@ </funcprototype> </funcsynopsis> <para> - Si <function>odbc_fetch_row</function> a réussi, &true; est - retourné. Si il n'y avait plus de ligne, ou en cas d'erreur, - &false; est retourné. + Si <function>odbc_fetch_row</function> a réussi, <literal>TRUE</literal> est + retourné. S'il n'y avait plus de ligne, ou en cas d'erreur, + <literal>FALSE</literal> est retourné. </para> <para> <function>odbc_fetch_row</function> lit une ligne dans le @@ -546,7 +608,7 @@ </para> <para> Si <parameter><optional>row_number</optional></parameter> est omis, - <parameter>row_number</parameter> va tenter de lire la prochaîne + <parameter>row_number</parameter> va tenter de lire la prochaine ligne dans le résultat. Des appels répétés à <function>odbc_fetch_row</function> avec et sans paramètre <parameter>row_number</parameter> peuvent être combinés librement. @@ -579,7 +641,7 @@ <function>odbc_field_name</function> lit le nom de la colonne dont l'index est <parameter>field_number</parameter>. La numérotation des champs commence à 1. - &false; est retourné en cas d'erreur. + <literal>FALSE</literal> est retourné en cas d'erreur. </para> </refsect1> </refentry> @@ -602,8 +664,8 @@ la colonne nommée <parameter>field_name</parameter>. Ce numéro correspond à l'index du champs dans le résultat ODBC. La numérotation commence à 1. - &false; est retourné en cas d'erreur. - </para> + <literal>FALSE</literal> est retourné en cas d'erreur. + </para> </refsect1> </refentry> <refentry id="function.odbc-field-type"> @@ -715,7 +777,7 @@ </funcsynopsis> <para> <function>odbc_free_result</function> retourne toujours - &true;.</para> + <literal>TRUE</literal>.</para> <para> <function>odbc_free_result</function> n'est nécessaire que si vous craignez d'utiliser trop de mémoire lors de @@ -811,11 +873,11 @@ </funcsynopsis> <para> <function>odbc_pconnect</function> retourne un identifiant de connexion - ODBC ou 0 (&false;) en cas d'erreur. + ODBC ou 0 (<literal>FALSE</literal>) en cas d'erreur. <function>odbc_pconnect</function> se comporte de manière similaire à <function>odbc_connect</function>, mais la connexion ouverte n'est pas vraiment terminée lorsque le script est - terminé. Les prochaînes requêtes qui se + terminé. Les prochaines requêtes qui se feront sur une connexion dont les <parameter>dsn</parameter>, <parameter>user</parameter>, <parameter>password</parameter> sont les mêmes que celle-ci (avec @@ -831,10 +893,10 @@ </note> </para> <para> - Pour plus de détails sur le paramètre optionel + Pour plus de détails sur le paramètre optionnel <parameter>cursor_type</parameter>, voyez <function>odbc_connect</function>. Pour plus de détails sur les connexions persistantes, - reportez vous à la FAQ PHP. + reportez-vous à la FAQ PHP. </para> </refsect1> </refentry> @@ -939,7 +1001,7 @@ <para> Les index de champs commencent à 1. Pour plus d'informations sur la façon de lire des colonnes de type binaire ou long, - reportez vous à <function>odbc_binmode</function> et + reportez-vous à <function>odbc_binmode</function> et <function>odbc_longreadlen</function>. <!-- If the requested field contains @@ -949,7 +1011,8 @@ need to have binary data returned, use the SQL function HEX() to retrieve the field in hexadecimal notation. E.g. "SELECT HEX(binary_col) FROM mytable" ---> </para> +--> + </para> </refsect1> </refentry> <refentry id="function.odbc-result-all"> @@ -970,7 +1033,7 @@ </funcsynopsis> <para> <function>odbc_result_all</function> retourne le nombre de lignes - dans le résultat, ou &false; en cas d'erreur. + dans le résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> <function>odbc_result_all</function> affiche toutes les lignes @@ -996,8 +1059,8 @@ <para> <function>odbc_rollback</function> annule toutes les transactions sur la connexion <parameter>connection_id</parameter>. - <function>odbc_rollback</function> retourne &true; en - cas de succès, et &false; en cas d'échec. + <function>odbc_rollback</function> retourne <literal>TRUE</literal> en + cas de succès, et <literal>FALSE</literal> en cas d'échec. </para> </refsect1> </refentry> @@ -1070,7 +1133,7 @@ // odbc_autocommit($conn, <literal>TRUE</literal>); odbc_setoption($conn, 1, 102, 1); // 2. Option 0 de SQLSetStmtOption() est SQL_QUERY_TIMEOUT. -// Cet exemple fixe le délai d'éxpiration à 30 secondes. +// Cet exemple fixe le délai d'expiration à 30 secondes. $result = odbc_prepare($conn, $sql); odbc_setoption($result, 2, 0, 30); odbc_execute($result); @@ -1102,7 +1165,7 @@ <para> <function>odbc_tables</function> liste toutes les tables de la source et retourne un identifiant de résultat ODBC, ou bien - &false; en cas d'erreur. + <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat contient les colonnes suivantes : @@ -1132,29 +1195,29 @@ <itemizedlist> <listitem> <simpara> - Si <parameter>qualifier</parameter> est un signe de pourcentage (%), - et <parameter>owner</parameter> et <parameter>name</parameter> sont - des chaînes vides, alors le résultat contient la liste des - qualifiers valides pour la source. (toutes les colonnes hormis - TABLE_QUALIFIER contiennent &null;). + Si <parameter>qualifier</parameter> est un signe de pourcentage (%), + et <parameter>owner</parameter> et <parameter>name</parameter> sont + des chaînes vides, alors le résultat contient la liste des + qualifiers valides pour la source. (toutes les colonnes hormis + TABLE_QUALIFIER contiennent NULL). </simpara> </listitem> <listitem> <simpara> - Si <parameter>owner</parameter> est un signe de pourcentage (%), - et <parameter>qualifier</parameter> et <parameter>name</parameter> - sont des chaînes vides, alors le résultat contient la liste des - propriétaires de la source (toutes les colonnes hormis - TABLE_OWNER contiennent &null;). + Si <parameter>owner</parameter> est un signe de pourcentage (%), + et <parameter>qualifier</parameter> et <parameter>name</parameter> + sont des chaînes vides, alors le résultat contient la liste des + propriétaires de la source (toutes les colonnes hormis + TABLE_OWNER contiennent NULL). </simpara> </listitem> <listitem> <simpara> - Si <parameter>table_type</parameter> est un signe de pourcentage (%), - et <parameter>qualifier</parameter>, <parameter>owner</parameter> et - <parameter>name</parameter> sont des chaînes vides, alors le résultat - contient la liste des types de tables de la source (toutes les colonnes hormis - TABLE_TYPE contiennent &null;). + Si <parameter>table_type</parameter> est un signe de pourcentage (%), + et <parameter>qualifier</parameter>, <parameter>owner</parameter> et + <parameter>name</parameter> sont des chaînes vides, alors le résultat + contient la liste des types de tables de la source (toutes les colonnes hormis + TABLE_TYPE contiennent NULL). </simpara> </listitem> </itemizedlist> @@ -1165,11 +1228,12 @@ qui representent les types recherchés. Chaque valeur peut être insérée entre guillemets simples ('), ou sans guillemets. Par exemple "'TABLE','VIEW'" ou "TABLE, VIEW". Si la source de données - ne supporte par un type de table donné, <function>odbc_tables</function> + ne supporte pas un type de table donné, <function>odbc_tables</function> ne retournera aucun résultat pour ce type. </para> <simpara> - Voir aussi <function>odbc_tableprivileges</function> pour connaître + Voir aussi + <function>odbc_tableprivileges</function> pour connaître les droits associés. </simpara> </refsect1> @@ -1196,7 +1260,7 @@ <function>odbc_tableprivileges</function> liste les tables de la source et leurs droits associés. <function>odbc_tableprivileges</function> retourne un identifiant de résultat ODBC, ou bien - &false; en cas d'erreur. + <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1244,7 +1308,7 @@ <function>odbc_columns</function> liste toutes les colonnes de la source dedonnées. <function>odbc_columns</function> retourne un identifiant de résultat ODBC, ou bien - &false; en cas d'erreur. + <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1302,7 +1366,7 @@ <function>odbc_columnprivileges</function> liste les colonnes et leurs droits associés pour la table <parameter>table_name</parameter>. <function>odbc_columnprivileges</function> retourne un identifiant - de résultat ODBC, ou bien &false; en cas d'erreur. + de résultat ODBC, ou bien <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1346,7 +1410,7 @@ <para> <function>odbc_gettypeinfo</function> liste les types de données qui sont supportées par une source. <function>odbc_gettypeinfo</function> - retourne un identifiant de résultat, ou &false; + retourne un identifiant de résultat, ou <literal>FALSE</literal> en cas d'erreur. L'argument optionnel <parameter>data_type</parameter> peut être utilisé pour restreindre les informations à un seul type de données. @@ -1397,7 +1461,7 @@ <function>odbc_primarykeys</function> liste les colonnes utilisées dans une clé primaire de la table <parameter>table</parameter>. <function>odbc_primarykeys</function> - retourne un identifiant de résultat, ou &false; + retourne un identifiant de résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> @@ -1438,7 +1502,7 @@ <function>odbc_foreignkeys</function> liste les clés étrangèes utilisées dans la table <parameter>pk_table</parameter>. <function>odbc_foreignkeys</function> retourne un identifiant de - résultat, ou &false; en cas d'erreur. + résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1501,7 +1565,7 @@ <para> <function>odbc_procedures</function> liste toutes les procédures stockées dans la source de données. <function>odbc_procedures</function> - retourne un identifiant de résultat, ou &false; + retourne un identifiant de résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> @@ -1528,7 +1592,7 @@ <refnamediv> <refname>odbc_procedurecolumns</refname> <refpurpose> - Liste les paramètres des procédures + Liste les paramètres des procédures </refpurpose> </refnamediv> <refsect1> @@ -1548,7 +1612,7 @@ d'entrée et de sortie, ainsi que les colonnes utilisées dans les procédures désignées par les paramètres. <function>odbc_procedurecolumns</function> etourne un identifiant de - résultat, ou &false; en cas d'erreur. + résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1615,7 +1679,7 @@ </simpara> <simpara> <function>odbc_specialcolumns</function> retourne un identifiant - de résultat, ou &false; en cas d'erreur. + de résultat, ou <literal>FALSE</literal> en cas d'erreur. </simpara> <para> Le résultat possède les colonnes suivantes : @@ -1657,7 +1721,7 @@ <function>odbc_statistics</function> effectue quelques statistiques sur une tables et ses index. <function>odbc_statistics</function> retourne un identifiant de résultat, ou - &false; en cas d'erreur. + <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes :
Index: phpdoc/fr/functions/uodbc.xml diff -u phpdoc/fr/functions/uodbc.xml:1.11 phpdoc/fr/functions/uodbc.xml:1.12 --- phpdoc/fr/functions/uodbc.xml:1.11 Sat Jul 7 18:22:27 2001 +++ phpdoc/fr/functions/uodbc.xml Thu Jul 12 08:16:17 2001 @@ -19,7 +19,7 @@ <ulink url="&url.sybase;">Sybase SQL Anywhere</ulink>. </simpara> <simpara> - Reportez vous à + Reportez-vous à <link linkend="install.configure.databases">Installation sous Unix</link> pour plus de détails sur les configurations de ces serveurs. </simpara> @@ -29,7 +29,7 @@ données ci-dessus. Les fonctions que vous utiliserez portent des noms évocateurs, et utilisent les mêmes syntaxes que leurs cousines d'ODBC. L'exception à ceci est iODBC. En compilant PHP avec le - suppport iODBC, vous pourrez utiliser n'importe quel pilote + support iODBC, vous pourrez utiliser n'importe quel pilote compatible ODBC avec vos applications PHP. iODBC est mis à jour à <ulink url="&url.openlink;">OpenLink Software</ulink>. Plus d'informations sur iODBC, ainsi qu'un HOWTO (en anglais), est disponible à @@ -40,7 +40,7 @@ <refentry id="function.odbc-autocommit"> <refnamediv> <refname>odbc_autocommit</refname> - <refpurpose>Mode auto-validation</refpurpose> + <refpurpose>Active le mode auto-validation</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -54,15 +54,15 @@ <para> Sans le paramètre <parameter>OnOff</parameter>, <function>odbc_autocommit</function> retourne le statut d'auto-validation - de la connexion <parameter>connection_id</parameter>. &true; - si le mode est activé, &false; si il ne l'est pas, + de la connexion <parameter>connection_id</parameter>. <literal>TRUE</literal> + si le mode est activé, <literal>FALSE</literal> s'il ne l'est pas, ou si une erreur survient. </para> <para> - Si <parameter>OnOff</parameter> vaut &true;, l'auto-validation - est activée. Si il est &false;, l'auto-validation + Si <parameter>OnOff</parameter> vaut <literal>TRUE</literal>, l'auto-validation + est activée. S'il est <literal>FALSE</literal>, l'auto-validation est désactivée. <function>odbc_autocommit</function> retourne - &true; en cas de succès, &false; + <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal> en cas d'échec. </para> <para> @@ -80,7 +80,7 @@ <refentry id="function.odbc-binmode"> <refnamediv> <refname>odbc_binmode</refname> - <refpurpose>Gestion des colonnes de données binaires.</refpurpose> + <refpurpose>Modifie la gestion des colonnes de données binaires.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -122,48 +122,48 @@ <title>Conversion des LONGVARBINARY </title> <tgroup cols="3"> <thead> - <row> - <entry>mode</entry> - <entry>longueur</entry> - <entry>résultat</entry> - </row> + <row> + <entry>mode</entry> + <entry>longueur</entry> + <entry>résultat</entry> + </row> </thead> <tbody> - <row> - <entry>ODBC_BINMODE_PASSTHRU</entry> - <entry>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_RETURN</entry> - <entry>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_CONVERT</entry> - <entry>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_PASSTHRU</entry> - <entry>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_PASSTHRU</entry> - <entry>>0</entry> - <entry>passthru</entry> - </row> - <row> - <entry>ODBC_BINMODE_RETURN</entry> - <entry>>0</entry> - <entry>Tel quel</entry> - </row> - <row> - <entry>ODBC_BINMODE_CONVERT</entry> - <entry>>0</entry> - <entry>Caractère</entry> - </row> + <row> + <entry>ODBC_BINMODE_PASSTHRU</entry> + <entry>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_RETURN</entry> + <entry>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_CONVERT</entry> + <entry>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_PASSTHRU</entry> + <entry>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_PASSTHRU</entry> + <entry>>0</entry> + <entry>passthru</entry> + </row> + <row> + <entry>ODBC_BINMODE_RETURN</entry> + <entry>>0</entry> + <entry>Tel quel</entry> + </row> + <row> + <entry>ODBC_BINMODE_CONVERT</entry> + <entry>>0</entry> + <entry>Caractère</entry> + </row> </tbody> </tgroup> </table> @@ -180,7 +180,7 @@ La valeur par défaut de <literal>4096</literal> est 4096 et les valeurs par défaut de odbc_binmode est <literal>ODBC_BINMODE_RETURN</literal>. La gestion des colonnes - binaires est aussi modifié par <function>odbc_longreadlen</function>. + binaires est aussi modifiée par <function>odbc_longreadlen</function>. </simpara> </note> </para> @@ -205,7 +205,7 @@ l'identifiant de connexion <parameter>connection_id</parameter>. <note> <simpara> - <function>odbc_close</function> échouera si il y a des + <function>odbc_close</function> échouera s'il y a des transactions en cours sur cette connexion. Dans ce cas, la connexion restera ouverte. </simpara> @@ -231,7 +231,7 @@ ODBC à des sources de données. <note> <simpara> - <function>odbc_close_all</function> échouera si il y a des + <function>odbc_close_all</function> échouera s'il y a des transactions en cours sur cette connexion. Dans ce cas, la connexion restera ouverte. </simpara> @@ -253,8 +253,8 @@ </funcprototype> </funcsynopsis> <para> - <function>odbc_commit</function> retourne &true; en - cas de succès, &false; en cas d'erreur. Toutes + <function>odbc_commit</function> retourne <literal>TRUE</literal> en + cas de succès, <literal>FALSE</literal> en cas d'erreur. Toutes les connexions en cours sur <parameter>connection_id</parameter> sont validées. </para> @@ -278,7 +278,7 @@ </funcsynopsis> <para> <function>odbc_connect</function> retourne un identifiant de connexion ODBC - ou 0 (&false;) en cas d'erreur. + ou 0 (<literal>FALSE</literal>) en cas d'erreur. </para> <simpara> L'identifiant de connexion retournée par cette fonction est @@ -295,7 +295,7 @@ "Cannot open a cursor on a stored procedure that has anything other than a single select statement in it", ce qui signifie : "Impossible de créer un pointeur de résultat dans une procédure - enregistrée qui est réduite à une simple selection + enregistrée qui est réduite à une simple sélection (SELECT)). Utiliser l'option SQL_CUR_USE_ODBC permet d'éviter cette erreur. De plus, certains pilotes ne supportent le paramètre optionnel de numéro de ligne dans <function>odbc_fetch_row</function>. @@ -308,27 +308,27 @@ <itemizedlist> <listitem> <simpara> - SQL_CUR_USE_IF_NEEDED + SQL_CUR_USE_IF_NEEDED </simpara> </listitem> <listitem> <simpara> - SQL_CUR_USE_ODBC + SQL_CUR_USE_ODBC </simpara> </listitem> <listitem> <simpara> - SQL_CUR_USE_DRIVER + SQL_CUR_USE_DRIVER </simpara> </listitem> <listitem> <simpara> - SQL_CUR_DEFAULT + SQL_CUR_DEFAULT </simpara></listitem> </itemizedlist> </para> <simpara> - Pour les connexions persistantes, reportez vous à + Pour les connexions persistantes, reportez-vous à <function>odbc_pconnect</function>. </simpara> </refsect1> @@ -367,7 +367,7 @@ </funcprototype> </funcsynopsis> <para> - <function>odbc_do</function> excécute la requête + <function>odbc_do</function> exécute la requête <parameter>query</parameter> avec la connexion <parameter>connection_id</parameter>. </para> </refsect1> @@ -395,7 +395,7 @@ </simpara> <simpara> Voir aussi - <function>odbc_errormsg</function> et + <function>odbc_errormsg</function> et <function>odbc_exec</function>. </simpara> </refsect1> @@ -445,7 +445,7 @@ </funcprototype> </funcsynopsis> <para> - <function>odbc_exec</function> retourne &false; + <function>odbc_exec</function> retourne <literal>FALSE</literal> en cas d'erreur, ou bien retourne un identifiant de résultat ODBC en cas d'exécution réussie. </para> @@ -472,20 +472,22 @@ </refnamediv> <refsect1> <title>Description</title> - <funcsynopsis> + <funcsynopsis> + <funcprototype> <funcdef>int <function>odbc_execute</function></funcdef> <paramdef>resource <parameter>result_id</parameter></paramdef> <paramdef>array <parameter><optional>parameters_array</optional></parameter></paramdef> - </funcsynopsis> + </funcprototype> + </funcsynopsis> <para> <function>odbc_execute</function> exécute une requête SQL préparée par <function>odbc_prepare</function>. - <function>odbc_execute</function> retourne &true; - en cas d'exécution réussie, et &false; + <function>odbc_execute</function> retourne <literal>TRUE</literal> + en cas d'exécution réussie, et <literal>FALSE</literal> sinon. Le tableau de paramètres <parameter>parameters_array</parameter> ne sert que si vous avez - besoin de paramètres votre requête. + besoin de paramètrer votre requête. </para> </refsect1> </refentry> @@ -493,7 +495,7 @@ <refnamediv> <refname>odbc_fetch_into</refname> <refpurpose> - Lit une ligne de résultat, et la place dans un tableau. + Lit une ligne de résultat, et la place dans un tableau. </refpurpose> </refnamediv> <refsect1> @@ -508,13 +510,73 @@ </funcsynopsis> <para> <function>odbc_fetch_into</function> retourne le nombre de colonnes - dans le résultat, ou &false; en cas d'erreur. + dans le résultat, ou <literal>FALSE</literal> en cas d'erreur. <parameter>result_array</parameter> doit avoir été passé par référence, mais il peut être de n'importe quel type, étant donné qu'il sera converti en tableau. Le tableau contiendra les valeurs des colonnes, ces dernières étant numérotées à partir de 0. </para> + <para> + <example> + <title>Exemple avec <function>odbc_fetch_into</function> (avant PHP 4.0.6)</title> + <programlisting role="php"> +<?php + $rc = odbc_fetch_into($res_id, $my_array); +?> + </programlisting> + </example> + ou + <informalexample> + <programlisting role="php"> +<?php + $rc = odbc_fetch_into($res_id, $row, $my_array); + $rc = odbc_fetch_into($res_id, 1, $my_array); +?> + </programlisting> + </informalexample> + </para> + <para> + Jusqu'en PHP 4.0.5, le paramètre <parameter>result_array</parameter> n'a plus + besoin d'être passé par référence. + </para> + <para> + Depuis PHP 4.0.6, le paramètre <parameter>rownumber</parameter> ne peut pas + être passé comme une constante, mais comme une variable. + </para> + <para> + <example> + <title>Exemple avec <function>odbc_fetch_into</function> (après PHP 4.0.6)</title> + <programlisting role="php"> +<?php + $rc = odbc_fetch_into($res_id, $my_array); +?> + </programlisting> + </example> + ou + <informalexample> + <programlisting role="php"> +<?php + $row = 1; + $rc = odbc_fetch_into($res_id, $row, $my_array); +?> + </programlisting> + </informalexample> + </para> + <para> + Evolution ultérieure : en PHP 4.1, <function>odbc_fetch_into</function> + aura le format suivant : + <funcsynopsis> + <funcprototype> + <funcdef>int <function>odbc_fetch_into</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>array <parameter>result_array</parameter></paramdef> + <paramdef>int <parameter><optional>rownumber</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + Notez que le paramètre <parameter>rownumber</parameter> sera optionnel, tandis que + <parameter>result_array</parameter> ne l'est pas. + </para> </refsect1> </refentry> <refentry id="function.odbc-fetch-row"> @@ -532,9 +594,9 @@ </funcprototype> </funcsynopsis> <para> - Si <function>odbc_fetch_row</function> a réussi, &true; est - retourné. Si il n'y avait plus de ligne, ou en cas d'erreur, - &false; est retourné. + Si <function>odbc_fetch_row</function> a réussi, <literal>TRUE</literal> est + retourné. S'il n'y avait plus de ligne, ou en cas d'erreur, + <literal>FALSE</literal> est retourné. </para> <para> <function>odbc_fetch_row</function> lit une ligne dans le @@ -546,7 +608,7 @@ </para> <para> Si <parameter><optional>row_number</optional></parameter> est omis, - <parameter>row_number</parameter> va tenter de lire la prochaîne + <parameter>row_number</parameter> va tenter de lire la prochaine ligne dans le résultat. Des appels répétés à <function>odbc_fetch_row</function> avec et sans paramètre <parameter>row_number</parameter> peuvent être combinés librement. @@ -579,7 +641,7 @@ <function>odbc_field_name</function> lit le nom de la colonne dont l'index est <parameter>field_number</parameter>. La numérotation des champs commence à 1. - &false; est retourné en cas d'erreur. + <literal>FALSE</literal> est retourné en cas d'erreur. </para> </refsect1> </refentry> @@ -602,8 +664,8 @@ la colonne nommée <parameter>field_name</parameter>. Ce numéro correspond à l'index du champs dans le résultat ODBC. La numérotation commence à 1. - &false; est retourné en cas d'erreur. - </para> + <literal>FALSE</literal> est retourné en cas d'erreur. + </para> </refsect1> </refentry> <refentry id="function.odbc-field-type"> @@ -715,7 +777,7 @@ </funcsynopsis> <para> <function>odbc_free_result</function> retourne toujours - &true;.</para> + <literal>TRUE</literal>.</para> <para> <function>odbc_free_result</function> n'est nécessaire que si vous craignez d'utiliser trop de mémoire lors de @@ -811,11 +873,11 @@ </funcsynopsis> <para> <function>odbc_pconnect</function> retourne un identifiant de connexion - ODBC ou 0 (&false;) en cas d'erreur. + ODBC ou 0 (<literal>FALSE</literal>) en cas d'erreur. <function>odbc_pconnect</function> se comporte de manière similaire à <function>odbc_connect</function>, mais la connexion ouverte n'est pas vraiment terminée lorsque le script est - terminé. Les prochaînes requêtes qui se + terminé. Les prochaines requêtes qui se feront sur une connexion dont les <parameter>dsn</parameter>, <parameter>user</parameter>, <parameter>password</parameter> sont les mêmes que celle-ci (avec @@ -831,10 +893,10 @@ </note> </para> <para> - Pour plus de détails sur le paramètre optionel + Pour plus de détails sur le paramètre optionnel <parameter>cursor_type</parameter>, voyez <function>odbc_connect</function>. Pour plus de détails sur les connexions persistantes, - reportez vous à la FAQ PHP. + reportez-vous à la FAQ PHP. </para> </refsect1> </refentry> @@ -939,7 +1001,7 @@ <para> Les index de champs commencent à 1. Pour plus d'informations sur la façon de lire des colonnes de type binaire ou long, - reportez vous à <function>odbc_binmode</function> et + reportez-vous à <function>odbc_binmode</function> et <function>odbc_longreadlen</function>. <!-- If the requested field contains @@ -949,7 +1011,8 @@ need to have binary data returned, use the SQL function HEX() to retrieve the field in hexadecimal notation. E.g. "SELECT HEX(binary_col) FROM mytable" ---> </para> +--> + </para> </refsect1> </refentry> <refentry id="function.odbc-result-all"> @@ -970,7 +1033,7 @@ </funcsynopsis> <para> <function>odbc_result_all</function> retourne le nombre de lignes - dans le résultat, ou &false; en cas d'erreur. + dans le résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> <function>odbc_result_all</function> affiche toutes les lignes @@ -996,8 +1059,8 @@ <para> <function>odbc_rollback</function> annule toutes les transactions sur la connexion <parameter>connection_id</parameter>. - <function>odbc_rollback</function> retourne &true; en - cas de succès, et &false; en cas d'échec. + <function>odbc_rollback</function> retourne <literal>TRUE</literal> en + cas de succès, et <literal>FALSE</literal> en cas d'échec. </para> </refsect1> </refentry> @@ -1070,7 +1133,7 @@ // odbc_autocommit($conn, <literal>TRUE</literal>); odbc_setoption($conn, 1, 102, 1); // 2. Option 0 de SQLSetStmtOption() est SQL_QUERY_TIMEOUT. -// Cet exemple fixe le délai d'éxpiration à 30 secondes. +// Cet exemple fixe le délai d'expiration à 30 secondes. $result = odbc_prepare($conn, $sql); odbc_setoption($result, 2, 0, 30); odbc_execute($result); @@ -1102,7 +1165,7 @@ <para> <function>odbc_tables</function> liste toutes les tables de la source et retourne un identifiant de résultat ODBC, ou bien - &false; en cas d'erreur. + <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat contient les colonnes suivantes : @@ -1132,29 +1195,29 @@ <itemizedlist> <listitem> <simpara> - Si <parameter>qualifier</parameter> est un signe de pourcentage (%), - et <parameter>owner</parameter> et <parameter>name</parameter> sont - des chaînes vides, alors le résultat contient la liste des - qualifiers valides pour la source. (toutes les colonnes hormis - TABLE_QUALIFIER contiennent &null;). + Si <parameter>qualifier</parameter> est un signe de pourcentage (%), + et <parameter>owner</parameter> et <parameter>name</parameter> sont + des chaînes vides, alors le résultat contient la liste des + qualifiers valides pour la source. (toutes les colonnes hormis + TABLE_QUALIFIER contiennent NULL). </simpara> </listitem> <listitem> <simpara> - Si <parameter>owner</parameter> est un signe de pourcentage (%), - et <parameter>qualifier</parameter> et <parameter>name</parameter> - sont des chaînes vides, alors le résultat contient la liste des - propriétaires de la source (toutes les colonnes hormis - TABLE_OWNER contiennent &null;). + Si <parameter>owner</parameter> est un signe de pourcentage (%), + et <parameter>qualifier</parameter> et <parameter>name</parameter> + sont des chaînes vides, alors le résultat contient la liste des + propriétaires de la source (toutes les colonnes hormis + TABLE_OWNER contiennent NULL). </simpara> </listitem> <listitem> <simpara> - Si <parameter>table_type</parameter> est un signe de pourcentage (%), - et <parameter>qualifier</parameter>, <parameter>owner</parameter> et - <parameter>name</parameter> sont des chaînes vides, alors le résultat - contient la liste des types de tables de la source (toutes les colonnes hormis - TABLE_TYPE contiennent &null;). + Si <parameter>table_type</parameter> est un signe de pourcentage (%), + et <parameter>qualifier</parameter>, <parameter>owner</parameter> et + <parameter>name</parameter> sont des chaînes vides, alors le résultat + contient la liste des types de tables de la source (toutes les colonnes hormis + TABLE_TYPE contiennent NULL). </simpara> </listitem> </itemizedlist> @@ -1165,11 +1228,12 @@ qui representent les types recherchés. Chaque valeur peut être insérée entre guillemets simples ('), ou sans guillemets. Par exemple "'TABLE','VIEW'" ou "TABLE, VIEW". Si la source de données - ne supporte par un type de table donné, <function>odbc_tables</function> + ne supporte pas un type de table donné, <function>odbc_tables</function> ne retournera aucun résultat pour ce type. </para> <simpara> - Voir aussi <function>odbc_tableprivileges</function> pour connaître + Voir aussi + <function>odbc_tableprivileges</function> pour connaître les droits associés. </simpara> </refsect1> @@ -1196,7 +1260,7 @@ <function>odbc_tableprivileges</function> liste les tables de la source et leurs droits associés. <function>odbc_tableprivileges</function> retourne un identifiant de résultat ODBC, ou bien - &false; en cas d'erreur. + <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1244,7 +1308,7 @@ <function>odbc_columns</function> liste toutes les colonnes de la source dedonnées. <function>odbc_columns</function> retourne un identifiant de résultat ODBC, ou bien - &false; en cas d'erreur. + <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1302,7 +1366,7 @@ <function>odbc_columnprivileges</function> liste les colonnes et leurs droits associés pour la table <parameter>table_name</parameter>. <function>odbc_columnprivileges</function> retourne un identifiant - de résultat ODBC, ou bien &false; en cas d'erreur. + de résultat ODBC, ou bien <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1346,7 +1410,7 @@ <para> <function>odbc_gettypeinfo</function> liste les types de données qui sont supportées par une source. <function>odbc_gettypeinfo</function> - retourne un identifiant de résultat, ou &false; + retourne un identifiant de résultat, ou <literal>FALSE</literal> en cas d'erreur. L'argument optionnel <parameter>data_type</parameter> peut être utilisé pour restreindre les informations à un seul type de données. @@ -1397,7 +1461,7 @@ <function>odbc_primarykeys</function> liste les colonnes utilisées dans une clé primaire de la table <parameter>table</parameter>. <function>odbc_primarykeys</function> - retourne un identifiant de résultat, ou &false; + retourne un identifiant de résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> @@ -1438,7 +1502,7 @@ <function>odbc_foreignkeys</function> liste les clés étrangèes utilisées dans la table <parameter>pk_table</parameter>. <function>odbc_foreignkeys</function> retourne un identifiant de - résultat, ou &false; en cas d'erreur. + résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1501,7 +1565,7 @@ <para> <function>odbc_procedures</function> liste toutes les procédures stockées dans la source de données. <function>odbc_procedures</function> - retourne un identifiant de résultat, ou &false; + retourne un identifiant de résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> @@ -1528,7 +1592,7 @@ <refnamediv> <refname>odbc_procedurecolumns</refname> <refpurpose> - Liste les paramètres des procédures + Liste les paramètres des procédures </refpurpose> </refnamediv> <refsect1> @@ -1548,7 +1612,7 @@ d'entrée et de sortie, ainsi que les colonnes utilisées dans les procédures désignées par les paramètres. <function>odbc_procedurecolumns</function> etourne un identifiant de - résultat, ou &false; en cas d'erreur. + résultat, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes : @@ -1615,7 +1679,7 @@ </simpara> <simpara> <function>odbc_specialcolumns</function> retourne un identifiant - de résultat, ou &false; en cas d'erreur. + de résultat, ou <literal>FALSE</literal> en cas d'erreur. </simpara> <para> Le résultat possède les colonnes suivantes : @@ -1657,7 +1721,7 @@ <function>odbc_statistics</function> effectue quelques statistiques sur une tables et ses index. <function>odbc_statistics</function> retourne un identifiant de résultat, ou - &false; en cas d'erreur. + <literal>FALSE</literal> en cas d'erreur. </para> <para> Le résultat possède les colonnes suivantes :