[PHP-DOC] cvs: phpdoc /fr/functions oracle.xml

[Damien Seguy]

dams            Thu Nov  1 11:42:55 2001 EDT

  Modified files:              
    /phpdoc/fr/functions        oracle.xml 
  Log:
  Typos.Adding xml stuff.
  
Index: phpdoc/fr/functions/oracle.xml
diff -u phpdoc/fr/functions/oracle.xml:1.8 phpdoc/fr/functions/oracle.xml:1.9
--- phpdoc/fr/functions/oracle.xml:1.8  Sat Jul  7 18:22:18 2001
+++ phpdoc/fr/functions/oracle.xml      Thu Nov  1 11:42:54 2001
@@ -1,10 +1,14 @@
+<?xml encoding="iso-8859-1"?>
+<!-- $Revision: 1.9 $ -->
  <reference id="ref.oracle">
   <title>Oracle</title>
   <titleabbrev>Oracle</titleabbrev>
   <refentry id="function.ora-bind">
    <refnamediv>
     <refname>Ora_Bind</refname>
-    <refpurpose>Lie une variable PHP &agrave; un param&egrave;tre Oracle.</refpurpose>
+    <refpurpose>
+     Lie une variable PHP &agrave; un param&egrave;tre Oracle.
+    </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -21,17 +25,17 @@
     <para>
      <function>ora_bind</function> retourne &true;
      si la liaison a pu se faire, et sinon &false;.
-     Les erreurs sont accessibles avec les fonctions <function>ora_error</function>
-     et <function>ora_errorcode</function>.
+     Les erreurs sont accessibles avec les fonctions    
+     <function>ora_error</function> et <function>ora_errorcode</function>.
     </para>
     <para>
      Cette fonction lie une variable PHP avec un param&egrave;tre SQL. Le
      param&egrave;tre SQL doit &ecirc;tre de la forme ":name". Avec l'option,
-     vous pouvez choisir si le param&egrave;tre SQL est de type entr&eacute;e/sortie
-     (0, valeur par d&eacute;faut), entr&eacute;e seulement (1) ou sortie
-     seulement (2). Comme dans PHP 3.0.1, vous pouvez respectivement utiliser
-     les constantes ORA_BIND_INOUT, ORA_BIND_IN eet ORA_BIND_OUT plut&ocirc;t
-     que des nombres.
+     vous pouvez choisir si le param&egrave;tre SQL est de type 
+     entr&eacute;e/sortie (0, valeur par d&eacute;faut), entr&eacute;e seulement
+     (1) ou sortie seulement (2). Comme dans PHP 3.0.1, vous pouvez
+     respectivement utiliser les constantes ORA_BIND_INOUT, ORA_BIND_IN et
+     ORA_BIND_OUT plut&ocirc;t que des nombres.
     </para>
     <para>
      <function>ora_bind</function> doit &ecirc;tre appel&eacute;e apr&egrave;s
@@ -49,7 +53,7 @@
 ora_bind($curs, "output", ":out", 5, 2);
 $input = 765;
 ora_exec($curs);
-echo "R&eacute;sultat: $result&lt;BR>Sortie: $output&lt;BR>Entr&eacute;e: $input";
+echo "R&eacute;sultat: $result&lt;br&gt;Sortie: $output&lt;br&gt;Entr&eacute;e: 
+$input";
 ?&gt;
       </programlisting>
      </informalexample>
@@ -76,8 +80,8 @@
      <function>ora_error</function> et <function>ora_errorcode</function>.
     </para>
     <para>
-     <function>ora_close</function> termine les pointeurs ouverts avec la fonction
-     <function>ora_open</function>.
+     <function>ora_close</function> termine les pointeurs ouverts avec la
+     fonction <function>ora_open</function>.
     </para>
    </refsect1>
   </refentry>
@@ -252,7 +256,8 @@
      <function>ora_do</function> est une combinaison de
      <function>ora_parse</function>, <function>ora_exec</function> et
      <function>ora_fetch</function>. Elle va analyser la requ&ecirc;te,
-     l'&eacute;x&eacute;cuter et lire la premi&egrave;re ligne du r&eacute;sultat.
+     l'&eacute;x&eacute;cuter et lire la premi&egrave;re ligne du
+     r&eacute;sultat.
     </para>
     <para>
      <function>ora_do</function> retourne &true; en cas
@@ -286,7 +291,7 @@
       <replaceable>NNNNN</replaceable> qui identifie le message d'erreur.
     <note>
      <para>
-       Le support des connexions a &eacute;t&eacute; ajout&eacute; dans PHP 3.0.4.
+      Le support des connexions a &eacute;t&eacute; ajout&eacute; en PHP 3.0.4.
      </para>
     </note>
    </para>
@@ -295,51 +300,53 @@
     d'erreur tels que :
     <computeroutput><prompt>$</prompt> <userinput>oerr ora 
<replaceable>00001</replaceable></userinput>
     00001, 00000, "unique constraint (%s.%s) violated" // *Cause: An update or insert
-statement attempted to insert a duplicate key //         For Trusted
-ORACLE configured in DBMS MAC mode, you may see //         this message
-if a duplicate entry exists at a different level.  // *Action: Either
-remove the unique restriction or do not insert the key </computeroutput>.
-    </para>
-   </refsect1>
-  </refentry>
-  <refentry id="function.ora-errorcode">
-   <refnamediv>
-    <refname>Ora_ErrorCode</refname>
-    <refpurpose>Retourne le code d'erreur Oracle.</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Description</title>
-    <funcsynopsis>
-     <funcprototype>
-      <funcdef>int <function>ora_errorcode</function></funcdef>
-      <paramdef>resource <parameter>cursor_or_connection</parameter></paramdef>
-     </funcprototype>
-    </funcsynopsis>
-    <para>
-      <function>ora_errorcode</function> retourne le code d'erreur
-      num&eacute;rique de la derni&egrave;re commande ex&eacute;cut&eacute;
-      sur la connexion ou le pointeur fourni en param&egrave;tre.
+    statement attempted to insert a duplicate key //         For Trusted
+    ORACLE configured in DBMS MAC mode, you may see //         this message
+    if a duplicate entry exists at a different level.  // *Action: Either
+    remove the unique restriction or do not insert the key </computeroutput>.
+   </para>
+  </refsect1>
+ </refentry>
+ <refentry id="function.ora-errorcode">
+  <refnamediv>
+   <refname>Ora_ErrorCode</refname>
+   <refpurpose>Retourne le code d'erreur Oracle.</refpurpose>
+  </refnamediv>
+  <refsect1>
+   <title>Description</title>
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>int <function>ora_errorcode</function></funcdef>
+     <paramdef>resource <parameter>cursor_or_connection</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <para>
+    <function>ora_errorcode</function> retourne le code d'erreur
+    num&eacute;rique de la derni&egrave;re commande ex&eacute;cut&eacute;
+    sur la connexion ou le pointeur fourni en param&egrave;tre.
     <note>
      <para>
-        Les identifiants de connexion ne sont accept&eacute;s qu'&agrave;
-        partir de la version 3.0.4.
+      Les identifiants de connexion ne sont accept&eacute;s qu'&agrave;
+      partir de la version 3.0.4.
      </para>
     </note>
    </para>
-   </refsect1>
-  </refentry>
-  <refentry id="function.ora-exec">
-   <refnamediv>
-    <refname>Ora_Exec</refname>
-    <refpurpose>
-      Ex&eacute;cute une commande analys&eacute;e sur un pointeur Oracle.
-    </refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Description</title>
+  </refsect1>
+ </refentry>
+ <refentry id="function.ora-exec">
+  <refnamediv>
+   <refname>Ora_Exec</refname>
+   <refpurpose>
+    Ex&eacute;cute une commande analys&eacute;e sur un pointeur Oracle.
+   </refpurpose>
+  </refnamediv>
+  <refsect1>
+   <title>Description</title>
     <funcsynopsis>
-     <funcdef>bool <function>ora_exec</function></funcdef>
-     <paramdef>resource <parameter>cursor</parameter></paramdef>
+     <funcprototype>
+    <funcdef>boolean <function>ora_exec</function></funcdef>
+    <paramdef>resource <parameter>cursor</parameter></paramdef>
+     </funcprototype>
     </funcsynopsis>
     <para>
      <function>ora_exec</function> retourne &true; en cas
@@ -376,60 +383,84 @@
     </simpara>
    </refsect1>
   </refentry>
-  <refentry id="function.ora-fetch-into">
-   <refnamediv>
-    <refname>Ora_Fetch_Into</refname>
-    <refpurpose>Lit une ligne dans un tableau</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Description</title>
-    <funcsynopsis>
-     <funcprototype>
-      <funcdef>int <function>ora_fetch_into</function></funcdef>
-      <paramdef>resource <parameter>cursor</parameter></paramdef>
-      <paramdef>array <parameter>result</parameter></paramdef>
-      <paramdef>int
-       <parameter>
-        <optional>flags</optional>
-       </parameter>
-      </paramdef>
-     </funcprototype>
-    </funcsynopsis>
-    <para>
-     <function>ora_fetch_into</function> lit la ligne courante du
-     r&eacute;sultat <parameter>cursor</parameter> dans le tableau
-     <parameter>result</parameter>.
-     <example>
-      <title>Exemple <function>ora_fetch_into</function></title>
-      <programlisting role="php">
+ <refentry id="function.ora-fetch-into">
+  <refnamediv>
+   <refname>Ora_Fetch_Into</refname>
+   <refpurpose>Lit une ligne dans un tableau</refpurpose>
+  </refnamediv>
+  <refsect1>
+   <title>Description</title>
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>int <function>ora_fetch_into</function></funcdef>
+     <paramdef>resource <parameter>cursor</parameter></paramdef>
+     <paramdef>array <parameter>result</parameter></paramdef>
+     <paramdef>int
+      <parameter>
+      <optional>flags</optional>
+      </parameter>
+     </paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <para>
+    <function>ora_fetch_into</function> lit la ligne courante du
+    r&eacute;sultat <parameter>cursor</parameter> dans le tableau
+    <parameter>result</parameter>.
+    <example>
+     <title>Exemple <function>ora_fetch_into</function></title>
+     <programlisting role="php">
 &lt;?php
 array($results);
 ora_fetch_into($cursor, &amp;$results);
 echo $results[0];
 echo $results[1];
 ?&gt;
-      </programlisting>
-     </example>
-     Notez que vous devez passer le tableau par r&eacute;f&eacute;rence;
-    </para>
-    <simpara>
-     Voir aussi <function>ora_parse</function>,<function>ora_exec</function>,
-     <function>ora_fetch</function>, et <function>ora_do</function>.
-    </simpara>
-   </refsect1>
-  </refentry>
-  <refentry id="function.ora-getcolumn">
-   <refnamediv>
-    <refname>Ora_GetColumn</refname>
-    <refpurpose>Retourne une donn&eacute;e d'une ligne lue.</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Description</title>
-    <funcsynopsis>
+     </programlisting>
+    </example>
+    Notez que vous devez passer le tableau par r&eacute;f&eacute;rence;
+   </para>
+   <simpara>
+    Voir aussi <function>ora_parse</function>,<function>ora_exec</function>,
+    <function>ora_fetch</function>, et <function>ora_do</function>.
+   </simpara>
+  </refsect1>
+ </refentry>
+ <refentry id="function.ora-getcolumn">
+  <refnamediv>
+   <refname>Ora_GetColumn</refname>
+   <refpurpose>Retourne une donn&eacute;e d'une ligne lue.</refpurpose>
+  </refnamediv>
+  <refsect1>
+   <title>Description</title>
+   <funcsynopsis>
+    <funcprototype>
+     <funcdef>mixed <function>ora_getcolumn</function></funcdef>
+     <paramdef>resource <parameter>cursor</parameter></paramdef>
+     <paramdef>mixed <parameter>column</parameter></paramdef>
+    </funcprototype>
+   </funcsynopsis>
+   <para>
+    <function>ora_getcolumn</function> retourne la valeur de la
+    colonne. Si une erreur survient, &false; est retourn&eacute; et
+    <function>ora_errorcode</function> aura une valeur non nulle.
+    Notez, qu'un test &agrave; &false;, avec cette fonction peut
+    &ecirc;tre \&true;, m&ecirc;me sans erreur : en effet, la fonction
+    peut retourner des valeurs telles que r&eacute;sultat &null;,
+    cha&icirc;nes vides, nombre 0, la cha&icirc;ne "0".
+   </para>
+  </refsect1>
+ </refentry>
+ <refentry id="function.ora-logoff">
+  <refnamediv>
+   <refname>Ora_Logoff</refname>
+   <refpurpose>Ferme une connexion Oracle.</refpurpose>
+  </refnamediv>
+  <refsect1>
+   <title>Description</title>
+   <funcsynopsis>
      <funcprototype>
-      <funcdef>mixed <function>ora_getcolumn</function></funcdef>
-      <paramdef>resource <parameter>cursor</parameter></paramdef>
-      <paramdef>mixed <parameter>column</parameter></paramdef>
+    <funcdef>int <function>ora_logoff</function></funcdef>
+    <paramdef>resource <parameter>connection</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
@@ -443,33 +474,6 @@
     </para>
    </refsect1>
   </refentry>
-  <refentry id="function.ora-logoff">
-   <refnamediv>
-    <refname>Ora_Logoff</refname>
-    <refpurpose>Ferme une connexion Oracle.</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Description</title>
-    <funcsynopsis>
-     <funcdef>int <function>ora_logoff</function></funcdef>
-     <paramdef>resource <parameter>connection</parameter></paramdef>
-    </funcsynopsis>
-    <para>
-      <function>ora_logoff</function> retourne &true; si la fermeture a
-      bien eu lieu, et &false; sinon. Les erreurs sont accessibles avec
-      les fonctions <function>ora_error</function> et
-      <function>ora_errorcode</function>.
-    </para>
-    <para>
-     <function>ora_logoff</function> d&eacute;connecte l'utilisateur,
-     et se d&eacute;connecte.
-   </para>
-    <simpara>
-     Voir aussi
-     <function>ora_logon</function>.
-    </simpara>
-   </refsect1>
-  </refentry>
   <refentry id="function.ora-logon">
    <refnamediv>
     <refname>Ora_Logon</refname>
@@ -533,8 +537,8 @@
     </funcsynopsis>
     <para>
      <function>ora_plogon</function> &eacute;tablit une connexion persistante
-     &agrave; un serveur Oracle, avec l'utilisateur <parameter>user</parameter> et
-     le mot de passe <parameter>password</parameter>.
+     &agrave; un serveur Oracle, avec l'utilisateur <parameter>user</parameter> 
+     et le mot de passe <parameter>password</parameter>.
     </para>
     <simpara>
      Voir aussi
@@ -557,8 +561,8 @@
     </funcsynopsis>
     <para>
      <function>ora_numcols</function> retourne le nombre de colonne dans le
-     r&eacute;sultat <parameter>cursor_ind</parameter>. Cette valeur n'est 
significative
-     qu'apr&egrave;s une requ&ecirc;te parse/exec/fetch.
+     r&eacute;sultat <parameter>cursor_ind</parameter>. Cette valeur n'est 
+     significative qu'apr&egrave;s une requ&ecirc;te parse/exec/fetch.
     </para>
     <simpara>
      Voir aussi <function>ora_parse</function>,<function>ora_exec</function>,
@@ -656,7 +660,8 @@
     </funcsynopsis>
     <para>
      <function>ora_rollback</function> annule une transaction Oracle. (Voir
-     <function>ora_commit</function> pour la d&eacute;finition d'une transaction).
+     <function>ora_commit</function> pour la d&eacute;finition d'une
+     transaction).
     </para>
     <para>
      <function>ora_rollback</function> retourne &true; si