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

[Damien Seguy]

dams            Thu Nov  1 11:31:16 2001 EDT

  Modified files:              
    /phpdoc/fr/functions        pgsql.xml 
  Log:
  Adding xml stuff.Adding lastest updates.Correcting minor typos.
  
Index: phpdoc/fr/functions/pgsql.xml
diff -u phpdoc/fr/functions/pgsql.xml:1.12 phpdoc/fr/functions/pgsql.xml:1.13
--- phpdoc/fr/functions/pgsql.xml:1.12  Sat Jul  7 18:22:20 2001
+++ phpdoc/fr/functions/pgsql.xml       Thu Nov  1 11:31:16 2001
@@ -1,3 +1,5 @@
+<?xml encoding="iso-8859-1"?>
+<!-- $Revision: 1.13 $ -->
  <reference id="ref.pgsql">
   <title>PostgreSQL</title>
   <titleabbrev>PostgreSQL</titleabbrev>
@@ -12,8 +14,8 @@
     il est Open Source et dans le domaine public.
    </para>
    <para>
-    PostgreSQL est disponible sans frais. La version actuelle est disponible &agrave;
-    (en anglais) : <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>.
+    PostgreSQL est disponible sans frais. La version actuelle est disponible
+    &agrave; (en anglais) : <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>.
    </para>
    <para>
     Depuis la version 6.3 (03/02/1998) PostgreSQL utilise les sockets UNIX, et
@@ -71,30 +73,32 @@
    </para>
    <para>
     L'ancienne syntaxe :
-    <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command>
+    <command>
+      $conn = pg_connect("host", "port", "options", "tty", "dbname")
+    </command>
     est obsol&egrave;te.
    </para>
    <para>
-     Pour utiliser l'interface des grands objets (large object (lo) interface), il
-     est n&eacute;cessaire de les placer dans un bloc de transaction. Un bloc de
-     transaction commence avec <command>begin</command> et si la transaction se
-     termine avec un <command>commit</command> et <command>end</command>. Si la
-     transaction &eacute;choue, elle doit &ecirc;tre conclue par un
+     Pour utiliser l'interface des grands objets (large object (lo) interface),
+     il est n&eacute;cessaire de les placer dans un bloc de transaction. Un bloc
+     de transaction commence avec <command>begin</command> et si la transaction
+     se termine avec un <command>commit</command> et <command>end</command>. Si
+     la transaction &eacute;choue, elle doit &ecirc;tre conclue par un
      <command>abort</command> et <command>rollback</command>.
     <example>
      <title>Utilisation des objets de grande taille (Large Objects)</title>
      <programlisting role="php">
 &lt;?php
-$database = pg_connect("", "", "", "", "jacarta");
-pg_exec($database, "begin");
-    $oid = pg_locreate($database);
-    echo "$oid\n";
-    $handle = pg_loopen($database, $oid, "w");
-    echo "$handle\n";
-    pg_lowrite($handle, "gaga");
-    pg_loclose($handle);
-    pg_exec($database, "commit")
-    pg_exec($database, "end")
+  $database = pg_connect("", "", "", "", "jacarta");
+  pg_exec($database, "begin");
+  $oid = pg_locreate($database);
+  echo "$oid\n";
+  $handle = pg_loopen($database, $oid, "w");
+  echo "$handle\n";
+  pg_lowrite($handle, "gaga");
+  pg_loclose($handle);
+  pg_exec($database, "commit")
+  pg_exec($database, "end")
 ?&gt;
      </programlisting>
     </example>
@@ -109,7 +113,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>pg_close</function></funcdef>
+      <funcdef>boolean <function>pg_close</function></funcdef>
       <paramdef>resource <parameter>connection</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -121,9 +125,9 @@
     </para>
     <note>
      <para>
-      Il n'est g&eacute;n&eacute;ralement pas n&eacute;cessaire de fermer une 
connexion
-      non persistante, car elles sont automatiquement ferm&eacute;es &agrave; la fin
-      d'un script.
+      Il n'est g&eacute;n&eacute;ralement pas n&eacute;cessaire de fermer une
+      connexion non persistante, car elles sont automatiquement ferm&eacute;es
+      &agrave; la fin d'un script.
      </para>
     </note>
     <para>
@@ -160,11 +164,16 @@
       </programlisting>
      </example>
     </para>
+    <para>
+     Voir aussi
+     <function>pg_numfields</function> et
+     <function>pg_numrows</function>.
+    </para>
    </refsect1>
   </refentry>
   <refentry id="function.pg-connect">
    <refnamediv>
-    <refname>pg_Connect</refname>
+    <refname>pg_connect</refname>
     <refpurpose>Ouvre une connexion.</refpurpose>
    </refnamediv>
    <refsect1>
@@ -172,6 +181,27 @@
     <funcsynopsis>
      <funcprototype>
       <funcdef>resource <function>pg_connect</function></funcdef>
+      <paramdef>string <parameter>host</parameter></paramdef>
+      <paramdef>string <parameter>port</parameter></paramdef>
+      <paramdef>string <parameter>dbname</parameter></paramdef>
+     </funcprototype>
+     <funcprototype>
+      <funcdef>resource <function>pg_connect</function></funcdef>
+      <paramdef>string <parameter>host</parameter></paramdef>
+      <paramdef>string <parameter>port</parameter></paramdef>
+      <paramdef>string <parameter>options</parameter></paramdef>
+      <paramdef>string <parameter>dbname</parameter></paramdef>
+     </funcprototype>
+     <funcprototype>
+      <funcdef>resource <function>pg_connect</function></funcdef>
+      <paramdef>string <parameter>host</parameter></paramdef>
+      <paramdef>string <parameter>port</parameter></paramdef>
+      <paramdef>string <parameter>options</parameter></paramdef>
+      <paramdef>string <parameter>tty</parameter></paramdef>
+      <paramdef>string <parameter>dbname</parameter></paramdef>
+     </funcprototype>
+     <funcprototype>
+      <funcdef>resource <function>pg_connect</function></funcdef>
       <paramdef>string <parameter>conn_string</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -181,20 +211,20 @@
      &agrave; un serveur PostgreSQL. Les arguments doivent &ecirc;tre plac&eacute;
      entre guillemets.
      <example>
-     <title>Using pg_connect arguments</title>
-     <programlisting role="php">
+     <title>Exemples avec <function>pg_connect</function></title>
+      <programlisting role="php">
 &lt;?php
-$dbconn = pg_connect("dbname=marie");
-//connexion &agrave; une base de donn&eacute;es nomm&eacute;e "marie"
-$dbconn2 = pg_connect("host=localhost port=5432 dbname=marie");
-//connexion &agrave; une base de donn&eacute;es nomm&eacute;e "marie" sur 
l'h&ocirc;te "localhost" sur le port "5432"
-$dbconn3 = pg_Connect ("host=sheep port=5432 dbname=marie user=mouton 
password=baaaa");
-//connection &agrave; une base de donn&eacute;es nomm&eacute;e "marie" sur le serveur 
"mouton" avec
-// un nom d'utilisateur et le mot de passe associ&eacute;
+  $dbconn = pg_connect("dbname=marie");
+  //connexion &agrave; une base de donn&eacute;es nomm&eacute;e "marie"
+  $dbconn2 = pg_connect("host=localhost port=5432 dbname=marie");
+  //connexion &agrave; une base de donn&eacute;es nomm&eacute;e "marie" sur 
+l'h&ocirc;te "localhost" sur le port "5432"
+  $dbconn3 = pg_Connect ("host=sheep port=5432 dbname=marie user=mouton 
+password=baaaa");
+  //connexion &agrave; une base de donn&eacute;es nomm&eacute;e "marie" sur le 
+serveur "mouton" avec
+  // un nom d'utilisateur et le mot de passe associ&eacute;
 ?&gt;
-     </programlisting>
+      </programlisting>
      </example>
-     Les arguments disponbiles comptent notamment <parameter>dbname</parameter>
+     Les arguments disponibles comptent notamment <parameter>dbname</parameter>
      <parameter>port</parameter>, <parameter>host</parameter>,
      <parameter>tty</parameter>, <parameter>options</parameter>,
      <parameter>user</parameter>, et <parameter>password</parameter>
@@ -204,13 +234,20 @@
      n&eacute;cessaire aux autres fonctions PostgreSQL. Vous pouvez ouvrir
      plusieurs connexions simultan&eacute;es.
     </para>
+     <para>
+     Si un deuxi&egrave;me appel &agrave; <function>pg_connect</function> est
+     fait avec les m&ecirc;mes arguments, aucune nouvelle connexion ne sera
+     &eacute;tablie, mais la connexion pr&eacute;c&eacute;dente sera
+     retourn&eacute;e.
+    </para>
     <para>
-     L'ancienne syntaxe
-     <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command>
-     est obsol&egrave;te.
+     L'ancienne syntaxe <command>
+      $conn = pg_connect("host", "port", "options", "tty", "dbname")
+     </command> est obsol&egrave;te.
     </para>
     <para>
-     Voir aussi <function>pg_pconnect</function>.
+     Voir aussi
+     <function>pg_pconnect</function>.
     </para>
    </refsect1>
   </refentry>
@@ -243,7 +280,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>pg_end_copy</function></funcdef>
+      <funcdef>boolean <function>pg_end_copy</function></funcdef>
       <paramdef>resource
        <parameter><optional>connection</optional></parameter>
       </paramdef>
@@ -251,10 +288,10 @@
     </funcsynopsis>
     <para>
      <function>pg_end_copy</function> synchronise le client PostgreSQL (ici PHP)
-     avec le serveur, apr&egrave;s une op&eacute;ration de copie. Il faut utiliser
-     cette fonction, sous peine de recevoir une erreur "out of sync"
-     (d&eacute;synchronis&eacute;). Retourne &true;
-     en cas de succ&egrave;s, et &false; sinon.
+     avec le serveur, apr&egrave;s une op&eacute;ration de copie. Il faut
+     utiliser cette fonction, sous peine de recevoir une erreur "out of sync"
+     (d&eacute;synchronis&eacute;). <function>pg_end_copy</function> retourne
+     &true; en cas de succ&egrave;s, et &false; sinon.
     </para>
     <para>
      Pour plus de d&eacute;tails et un exemple voyez :
@@ -303,8 +340,8 @@
     </funcsynopsis>
     <para>
      <function>pg_exec</function> retourne un index de r&eacute;sultat,
-     si la requ&ecirc;te a &eacute;t&eacute; correctement ex&eacute;cut&eacute;e,
-     et &false; en cas d'&eacute;chec, ou si
+     si la requ&ecirc;te a &eacute;t&eacute; correctement
+     ex&eacute;cut&eacute;e, et &false; en cas d'&eacute;chec, ou si
      la connexion connection n'&eacute;tait pas un index de connexion valide. En
      cas d'erreur, le message d'erreur peut &ecirc;tre obtenu gr&acirc;ce &agrave; la
      fonction <function>pg_errormessage</function>, si l'index de connexion
@@ -372,7 +409,7 @@
      qu'elle fournit un confort d'utilisation notable.
     </para>
     <para>
-     Pour plus de d&eacute;tails, reportez vous &agrave;
+     Pour plus de d&eacute;tails, reportez-vous &agrave;
      <function>pg_fetch_row</function>.
    </para>
     <example>
@@ -429,7 +466,7 @@
       (les nombres ne sont pas autoris&eacute;s comme nom de membre).
     </para>
     <para>
-      L'argument optionnel <parameter><optional>result_type</optional></parameter> de
+      L'argument optionnel <parameter>result_type</parameter> de
       <parameter>result_type</parameter> est une constante qui peut prendre les
       valeurs suivantes : PGSQL_ASSOC, PGSQL_NUM, et PGSQL_BOTH.
      <note>
@@ -445,10 +482,11 @@
      <function>pg_fetch_row</function> (la diff&eacute;rence est non significative).
     </para>
     <para>
-     Voir aussi: <function>pg_fetch_array</function> et
+     Voir aussi
+     <function>pg_fetch_array</function> et
      <function>pg_fetch_row</function>.
      <example>
-      <title>Postgres fetch object</title>
+      <title>Lecture d'un objet Postgres</title>
       <programlisting role="php">
 &lt;?php
 $database = "verlag";
@@ -523,8 +561,10 @@
      lorsqu'il n'y aura plus de lignes.
     </para>
     <para>
-     Voir aussi: <function>pg_fetch_array</function>,
-     <function>pg_fetch_object</function> et <function>pg_result</function>.
+     Voir aussi
+     <function>pg_fetch_array</function>,
+     <function>pg_fetch_object</function> et 
+     <function>pg_result</function>.
      <example>
       <title>Postgres retourne une ligne</title>
       <programlisting role="php">
@@ -545,7 +585,7 @@
   for ($j=0; $j&lt;count($r); $j++) {
     echo "$r[$j]&amp;nbsp;";
   }
-  echo "&lt;BR>";
+  echo "&lt;br&gt;";
 }
 ?&gt;
       </programlisting>
@@ -662,9 +702,10 @@
     </funcsynopsis>
     <para>
      <function>pg_fieldsize</function> retourne la taille interne de stockage
-     d'un champs donn&eacute;, en octets. Retourne -1 si la taille est variable.
-     RetourneFALSEen cas d'erreur. La num&eacute;rotation des colonnes
-     commence &agrave; 0.
+     d'un champs donn&eacute;, en octets. <function>pg_fieldsize</function>
+     retourne -1 si la taille est variable. <function>pg_fieldsize</function>
+     retourne <literal>FALSE</literal> en cas d'erreur. La num&eacute;rotation
+     des colonnes commence &agrave; 0.
     </para>
    </refsect1>
   </refentry>
@@ -729,7 +770,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>pg_getlastoid</function> sert &agrave; lire l' Oid assign&eacute;
+     <function>pg_getlastoid</function> sert &agrave; lire l'Oid assign&eacute;
      &agrave; un tuple ins&eacute;r&eacute;, si l'index de r&eacute;sultat a
      &eacute;t&eacute; obtenu avec la fonction <function>pg_exec</function>,
      dont la requ&ecirc;te &eacute;tait exclusivement SQL INSERT. Cette fonction
@@ -812,7 +853,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>pg_loexport</function></funcdef>
+      <funcdef>boolean <function>pg_loexport</function></funcdef>
       <paramdef>resource
        <parameter>oid</parameter>
       </paramdef>
@@ -825,9 +866,11 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     <parameter>oid</parameter> est un identifiant d'objet de grande taille
-     qui sera export&eacute; dans le fichier <parameter>filename</parameter>, qui
-     sp&eacute;cifie son chemin. RetourneFALSEsi une erreur survient,
+     <function>pg_loexport</function> exporte un objet de grande taille
+     dans un fichier. <parameter>oid</parameter> est un identifiant d'objet de
+     grande taille qui sera export&eacute; dans le fichier
+     <parameter>filename</parameter>,
+     qui sp&eacute;cifie son chemin. RetourneFALSEsi une erreur survient,
      et &true; en cas de succ&egrave;s.
      N'oubliez pas que la manipulation d'un objet de  grande taille
      dans PostgreSQL doit intervenir dans une transaction.
@@ -855,7 +898,7 @@
     <para>
      <parameter>filename</parameter> est le chemin jusqu'&agrave; un fichier
      qui servira de source pour cr&eacute;er un objet de grande taille.
-     La fonction retourneFALSEen cas d'erreur, et sinon
+     La fonction retourne <literal>FALSE</literal> en cas d'erreur, et sinon
      un identifiant d'objet, cr&eacute;&eacute; directement &agrave; la bonne taille.
      N'oubliez pas que la manipulation d'un objet de  grande taille
      dans PostgreSQL doit intervenir dans une transaction.
@@ -926,7 +969,7 @@
     <para>
      <function>pg_loreadall</function> lit un objet de grande taille en
      totalit&eacute; et le passe directement au client, apr&egrave;s les
-     ent&ecirc;tes ad&eacute;quats. Cette fonction est pr&eacute;vue
+     en-t&ecirc;tes ad&eacute;quates. Cette fonction est pr&eacute;vue
      pour transmettre des sons ou des images.
     </para>
    </refsect1>
@@ -946,7 +989,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
-     <function>pg_lounlink</function> efface l' objet de grande taille dont
+     <function>pg_lounlink</function> efface l'objet de grande taille dont
      l'identifiant est <parameter>lobjid</parameter>.
     </para>
    </refsect1>
@@ -969,7 +1012,7 @@
      <function>pg_lowrite</function> &eacute;crit dans l'objet de grande
      taille autant de donn&eacute;es possible, issues de la variable
      <parameter>buf</parameter> et retourne le nombre d'octets
-     r&eacute;ellement &eacute;crits, ouFALSEen cas d'erreur.
+     r&eacute;ellement &eacute;crits, ou <literal>FALSE</literal> en cas d'erreur.
      <parameter>fd</parameter> est un descripteut d'objet de grande taille,
      obtenu avec <function>pg_loopen</function>.
     </para>
@@ -994,6 +1037,11 @@
      un identifiant de r&eacute;sultat valide retourn&eacute; par
      <function>pg_exec</function>. Cette fonction retournera -1 en cas  d'erreur.
     </para>
+    <para>
+     Voir aussi 
+     <function>pg_numrows</function> et
+     <function>pg_cmdtuples</function>.
+    </para>
    </refsect1>
   </refentry>
   <refentry id="function.pg-numrows">
@@ -1015,6 +1063,11 @@
      identifiant de r&eacute;sultat valide retourn&eacute; par
      <function>pg_exec</function>. Cette fonction retournera -1 en cas d'erreur.
     </para>
+    <para>
+     Voir aussi
+     <function>pg_numfields</function> et
+     <function>pg_cmdtuples</function>.
+    </para>
    </refsect1>
   </refentry>
   <refentry id="function.pg-options">
@@ -1102,7 +1155,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>pg_put_line</function></funcdef>
+      <funcdef>boolean <function>pg_put_line</function></funcdef>
       <paramdef>resource
        <parameter><optional>connection_id</optional></parameter>
       </paramdef>
@@ -1113,9 +1166,10 @@
      <function>pg_put_line</function> envoie une cha&icirc;ne (termin&eacute;e
      par &null;) au serveur PostgreSQL. Ceci est pratique pour effectuer
      des insertions tr&egrave;s rapides dans une table, initi&eacute;e par une
-     op&eacute;ration de copie PostgreSQL copy-operation. Le caract&egrave;re final
-     &null; est automatiquement ajout&eacute;. Retourne &true;
-     en cas de succ&egrave;s, et &false;.
+     op&eacute;ration de copie PostgreSQL copy-operation. Le caract&egrave;re
+     final &null; est automatiquement ajout&eacute;.
+     <function>pg_put_line</function>  retourne &true; en cas de succ&egrave;s,
+     et &false;.
     </para>
     <note>
      <para>
@@ -1125,7 +1179,8 @@
      </para>
     </note>
     <para>
-     Voir aussi <function>pg_end_copy</function>.
+     Voir aussi 
+     <function>pg_end_copy</function>.
      <example>
       <title>Insertion &agrave; grande vitesse dans une table</title>
       <programlisting role="php">
@@ -1182,7 +1237,7 @@
    <refnamediv>
     <refname>pg_set_client_encoding</refname>
     <refpurpose>
-     Choisi l'encodage du client
+     Choisit l'encodage du client
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1217,7 +1272,8 @@
      </para>
     </note>
     <para>
-     Voir aussi <function>pg_client_encoding</function>.
+     Voir aussi 
+     <function>pg_client_encoding</function>.
     </para>
    </refsect1>
   </refentry>
@@ -1256,7 +1312,8 @@
      </para>
     </note>
     <para>
-     Voir aussi<function>pg_set_client_encoding</function>.
+     Voir aussi
+     <function>pg_set_client_encoding</function>.
     </para>
    </refsect1>
   </refentry>
@@ -1269,7 +1326,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>pg_trace</function></funcdef>
+      <funcdef>boolean <function>pg_trace</function></funcdef>
       <paramdef>string
        <parameter>filename</parameter>
       </paramdef>
@@ -1298,11 +1355,14 @@
      Par d&eacute;faut, c'est la derni&egrave;re ouverte.
     </para>
     <para>
-     Retourne &true; si <parameter>filename</parameter> a pu &ecirc;tre ouvert en
+     <function>pg_trace</function> retourne &true; si
+     <parameter>filename</parameter> a pu &ecirc;tre ouvert en
      &eacute;criture, etFALSEsinon.
     </para>
     <para>
-     Voir aussi <function>fopen</function> et <function>pg_untrace</function>.
+     Voir aussi
+     <function>fopen</function> et
+     <function>pg_untrace</function>.
     </para>
    </refsect1>
   </refentry>
@@ -1314,8 +1374,10 @@
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
+     <funcprototype>
      <funcdef>string <function>pg_tty</function></funcdef>
      <paramdef>resource <parameter>connection_id</parameter></paramdef>
+     </funcprototype>
     </funcsynopsis>
     <para>
      <function>pg_tty</function> retourne le nom de tty de la connexion
@@ -1332,7 +1394,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>bool <function>pg_untrace</function></funcdef>
+      <funcdef>boolean <function>pg_untrace</function></funcdef>
       <paramdef>resource
        <parameter><optional>connection</optional></parameter>
       </paramdef>
@@ -1348,7 +1410,8 @@
      <function>pg_untrace</function> retourne toujours &true;.
     </para>
     <para>
-     Voir aussi <function>pg_trace</function>.
+     Voir aussi
+     <function>pg_trace</function>.
     </para>
    </refsect1>
   </refentry>