derick          Wed Nov 14 12:43:39 2001 EDT

  Modified files:              
    /phpdoc/fr/functions        oci8.xml ovrimos.xml 
  Log:
  - Fixing parsing errors
  
  
Index: phpdoc/fr/functions/oci8.xml
diff -u phpdoc/fr/functions/oci8.xml:1.15 phpdoc/fr/functions/oci8.xml:1.16
--- phpdoc/fr/functions/oci8.xml:1.15   Mon Nov 12 18:37:22 2001
+++ phpdoc/fr/functions/oci8.xml        Wed Nov 14 12:43:38 2001
@@ -1,5 +1,5 @@
 <?xml encoding="iso-8859-1"?>
-<!-- $Revision: 1.15 $ -->
+<!-- $Revision: 1.16 $ -->
  <reference id="ref.oci8">
   <title>Oracle 8</title>
   <titleabbrev>oci8</titleabbrev>
@@ -708,9 +708,9 @@
      <title>Exemple avec <function>ocinewdescriptor</function></title>
      <programlisting>
 &lt;?php   
-    /* Appel d'une procˇdure PL/SQL stockˇe qui prend un clobs en entrˇe
-     * (PHP 4 >= 4.0.6). 
-     * Exemple de signateure de procˇdure stockˇe PL/SQL :
+    /* Appel d'une proc&eacute;dure PL/SQL stock&eacute;e qui prend un clobs
+     * en entr&eacute;e (PHP 4 >= 4.0.6). 
+     * Exemple de signateure de proc&eacute;dure stock&eacute;e PL/SQL :
      *
      * PROCEDURE save_data
      *   Nom de l'argument              Type                    In/Out Default?
Index: phpdoc/fr/functions/ovrimos.xml
diff -u phpdoc/fr/functions/ovrimos.xml:1.6 phpdoc/fr/functions/ovrimos.xml:1.7
--- phpdoc/fr/functions/ovrimos.xml:1.6 Mon Nov 12 18:37:22 2001
+++ phpdoc/fr/functions/ovrimos.xml     Wed Nov 14 12:43:38 2001
@@ -1 +1,806 @@
-<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.6 $ --><reference 
id="ref.ovrimos">  <title>Ovrimos SQL</title>  <titleabbrev>OvrimosSQL</titleabbrev>  
<partintro>   <para>    Ovrimos SQL Server est une base de donn&eacute;es 
relationnelle client/serveur    et transactionnelle, combin&eacute;e avec des 
fonctionnalit&eacute;s web, et des    transactions rapides.   </para>   <para>    
Ovrimos SQL Server est disponible &agrave; <ulink    
url="&url.ovrimos;">www.ovrimos.com</ulink>.  Pour activer le support    ovrimos de 
PHP, il suffit de compiler PHP avec l'option    <link 
linkend="install.configure.with-ovrimos"><option 
role="configure">--with-ovrimos</option></link>    du script de configuration. Vous 
devrez aussi installer la librairie sqlcli    disponible avec la distribution Ovrimos 
SQL Server.   </para>   <para>    <example>     <title>      Connection au serveur 
Ovrimos SQL Server et s&eacute;lection d'une table syst&egrave;me     </title>     
<programlisting role="php">&lt;?php$conn = ovrimos_connect("server.domain.com", 
"8001", "admin", "password");if ($conn != 0) {    echo ("Connection &eacute;tablie!"); 
   $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables");    if 
($res != 0) {        echo "Requ&ecirc;te effectu&eacute;e!";        
ovrimos_result_all($res);        ovrimos_free_result($res);    }    
ovrimos_close($conn);}?&gt;     </programlisting>    </example>    Cet exemple 
effectue une connexion r&eacute;ussie.   </para>  </partintro>  <refentry 
id="function.ovrimos-connect">   <refnamediv>    <refname>ovrimos_connect</refname>    
<refpurpose>Connexion &agrave; un serveur</refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_connect</function></funcdef>      <paramdef>string 
<parameter>host</parameter></paramdef>      <paramdef>string 
<parameter>db</parameter></paramdef>      <paramdef>string 
<parameter>user</parameter></paramdef>      <paramdef>string 
<parameter>password</parameter></paramdef>     </funcprototype>    </funcsynopsis>    
<para>     <function>ovrimos_connect</function> sert &agrave; se connecter &agrave; un 
serveur     Ovrimos.    </para>    <para>     <function>ovrimos_connect</function> 
retourne un identifiant de connexion,     sup&eacute;rieur &agrave; 0, ou 0 en cas 
d'&eacute;chec.<parameter>host</parameter>     est l'adresse IP de l'h&ocirc;te 
Ovrimos, et <parameter>db</parameter> est soit     le nom d'une base de 
donn&eacute;es, soit une cha&icirc;ne contenant      le num&eacute;ro de port.    
</para>    <para>     <example>      <title>Exemple avec 
<function>ovrimos_connect</function></title>      <programlisting 
role="php">&lt;?php$conn = ovrimos_connect("server.domain.com", "8001", "admin", 
"password");if ($conn != 0) {    echo "Connection &eacute;tablie!";    
$res=ovrimos_exec($conn, "select table_id, table_name from sys.tables");    if ($res 
!= 0) {        echo "Requ&ecirc;te effectu&eacute;e!";        
ovrimos_result_all($res);        ovrimos_free_result($res);    }    
ovrimos_close($conn);}?&gt;      </programlisting>     </example>     L'exemple 
ci-dessus montre comment se connecter &agrave; une base de donn&eacute;es     et 
afficher le contenu d'une table.    </para>   </refsect1>  </refentry>  <refentry 
id="function.ovrimos-close">   <refnamediv>    <refname>ovrimos_close</refname>    
<refpurpose>Ferme une connexion</refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>void 
<function>ovrimos_close</function></funcdef>      <paramdef>int 
<parameter>connection</parameter></paramdef>     </funcprototype>    </funcsynopsis>   
 <para>     <function>ovrimos_close</function> sert &agrave; ferme une connexion     
&agrave; un serveur Ovrimos.    </para>    <para>     
<function>ovrimos_close</function> ferme la connexion au serveur     Ovrimos. Toutes 
les transactions non valid&eacute;es sont annul&eacute;es.    </para>   </refsect1>  
</refentry><!--  <refentry id="function.ovrimos-close-all">   <refnamediv>    
<refname>ovrimos_close_all</refname>    <refpurpose>Ferme toutes les connexions aux 
serveurs ovrimos</refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>void 
<function>ovrimos_close_all</function></funcdef>      <paramdef>void</paramdef>     
</funcprototype>    </funcsynopsis>    <para>     
<function>ovrimos_close_all</function> sert &agrave; ferme toutes les connexions.    
</para>    <para>     <function>ovrimos_close_all</function> ferme toute les 
connexions &agrave;     Ovrimos. Toutes les transactions non valid&eacute;es sont 
annul&eacute;es.    </para>   </refsect1>  </refentry>-->  <refentry 
id="function.ovrimos-longreadlen">   <refnamediv>    
<refname>ovrimos_longreadlen</refname>    <refpurpose>     Indique la taille des 
donn&eacute;es &agrave; lire dans une colonne de grande taille    </refpurpose>   
</refnamediv>   <refsect1>    <title>Description</title>    <funcsynopsis>     
<funcprototype>      <funcdef>int <function>ovrimos_longreadlen</function></funcdef>   
   <paramdef>int <parameter>result_id</parameter></paramdef>      <paramdef>int 
<parameter>length</parameter></paramdef>     </funcprototype>    </funcsynopsis>    
<para>     <function>ovrimos_longreadlen</function> sert &agrave; lire la taille des   
  donn&eacute;es qui sera lues lors de l'acc&egrave;s une colonne de grande taille.    
</para>    <para>     <function>ovrimos_longreadlen</function> indique le nombre 
d'octets     qui seront lus dans une colonne de grande taille (long varchar et long    
 varbinary). Par d&eacute;faut, 0. Ind&eacute;pendemment du fait que     
<function>ovrimos_longreadlen</function> requiert <parameter>result_id</parameter>,    
 actuellement <function>ovrimos_longreadlen</function> affecte ce param&egrave;tre     
pour tous les r&eacute;sultats.    </para>   </refsect1>  </refentry>  <refentry 
id="function.ovrimos-prepare">   <refnamediv>    <refname>ovrimos_prepare</refname>    
<refpurpose>Pr&eacute;pare une requ&ecirc;te SQL</refpurpose>   </refnamediv>   
<refsect1>    <title>Description</title>    <funcsynopsis>     <funcprototype>      
<funcdef>int <function>ovrimos_prepare</function></funcdef>      <paramdef>int 
<parameter>connection_id</parameter></paramdef>      <paramdef>string 
<parameter>query</parameter></paramdef>     </funcprototype>    </funcsynopsis>    
<para>     <function>ovrimos_prepare</function> sert &agrave; pr&eacute;parer une 
requ&ecirc;te SQL.    </para>    <para>     <function>ovrimos_prepare</function> 
pr&eacute;pare une requ&ecirc;te SQL     et retourne un identifiant de r&eacute;sultat 
result_id (ou &false; en cas d'&eacute;chec).    </para>   <para>    <example>     
<title>      Connexion &agrave; un serveur Ovrimos SQL Server et pr&eacute;paration    
   d'une requ&ecirc;te     </title>     <programlisting 
role="php">&lt;?php$conn=ovrimos_connect("db_host", "8001", "admin", "password");if 
($conn!=0) {    echo "Connection &eacute;tablie!";    $res=ovrimos_prepare($conn, 
"select table_id, table_name                                  from sys.tables where 
table_id=1");    if ($res != 0) {        echo "Pr&eacute;paration faite!";        if 
(ovrimos_execute($res)) {            echo "Ex&eacute;cution r&eacute;ussie!\n";        
    ovrimos_result_all($res);        } else {            echo "Ex&eacute;cution 
manqu&eacute;e!";        }        ovrimos_free_result($res);    } else {        echo 
"Pr&eacute;paration manqu&eacute;e!\n";    }    ovrimos_close($conn);}?&gt;      
</programlisting>     </example>     Cet exemple montre comment se connecter &agrave; 
un serveur Ovrimos SQL Server,     comment pr&eacute;parer une requ&ecirc;te SQL et 
l'ex&eacute;cuter.    </para>   </refsect1>  </refentry>  <refentry 
id="function.ovrimos-execute">   <refnamediv>    <refname>ovrimos_execute</refname>    
<refpurpose>Ex&eacute;cute une requ&ecirc;te pr&eacute;par&eacute;e</refpurpose>   
</refnamediv>   <refsect1>    <title>Description</title>    <funcsynopsis>     
<funcprototype>      <funcdef>boolean <function>ovrimos_execute</function></funcdef>   
   <paramdef>int <parameter>result_id</parameter></paramdef>      <paramdef>array      
 <parameter><optional>parameters_array</optional></parameter>      </paramdef>     
</funcprototype>    </funcsynopsis>    <para>     <function>ovrimos_execute</function> 
sert &agrave; ex&eacute;cuter une requ&ecirc;te SQL.    </para>    <para>     
<function>ovrimos_execute</function> ex&eacute;cute une requ&ecirc;te     
pr&eacute;par&eacute;e. <function>ovrimos_execute</function>     retourne &true; ou 
&false;. Si la requ&ecirc;te pr&eacute;par&eacute;e     contient des param&egrave;tres 
(des points d'interrogations dans la     requ&ecirc;te), un nombre correct de 
param&egrave;tre doit &ecirc;tre     pass&eacute; dans le tableau 
<parameter>parameters_array</parameter>. Notez     que 
<function>ovrimos_execute</function> ne     suit pas les conventions PHP qui placent 
les noms des param&egrave;tres     entre crochets. L'auteur n'a pas pu s'y faire.    
</para>    </refsect1>  </refentry>  <refentry id="function.ovrimos-cursor">   
<refnamediv>    <refname>ovrimos_cursor</refname>    <refpurpose>Retourne le nom du 
curseur</refpurpose>   </refnamediv>   <refsect1>    <title>Description</title>    
<funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_cursor</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>     </funcprototype>    </funcsynopsis>    
<para>     <function>ovrimos_cursor</function> sert &agrave; lire le nom du curseur    
 </para>    <para>     <function>ovrimos_cursor</function> retourne le nom du curseur. 
    Pratique, lorsqu'on veut faire des modifications ou des effacements     avec des 
curseurs d&eacute;j&agrave; positionn&eacute;s.    </para>    </refsect1>  </refentry> 
 <refentry id="function.ovrimos-exec">   <refnamediv>    
<refname>ovrimos_exec</refname>    <refpurpose>Ex&eacute;cute une requ&ecirc;te 
SQL</refpurpose>   </refnamediv>   <refsect1>    <title>Description</title>    
<funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_exec</function></funcdef>      <paramdef>int 
<parameter>connection_id</parameter></paramdef>      <paramdef>string 
<parameter>query</parameter></paramdef>     </funcprototype>    </funcsynopsis>    
<para>     <function>ovrimos_exec</function> sert &agrave; ex&eacute;cuter une     
requ&ecirc;te SQL.    </para>    <para>     <function>ovrimos_exec</function> 
ex&eacute;cute une requ&ecirc;te SQL     (selection ou modification), et retourne un 
identifiant de r&eacute;sultat     result_id (ou bien &false;, en cas d'&eacute;chec). 
 Evidemment, la     requ&ecirc;te SQL ne doit pas contenir de param&egrave;tres.    
</para>   </refsect1>  </refentry>  <refentry id="function.ovrimos-fetch-into">   
<refnamediv>    <refname>ovrimos_fetch_into</refname>    <refpurpose>Lit une ligne 
dans un r&eacute;sultat</refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>boolean 
<function>ovrimos_fetch_into</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>      <paramdef>array 
<parameter>result_array</parameter></paramdef>      <paramdef>string       
<parameter><optional>how</optional></parameter>      </paramdef>      <paramdef>int    
   <parameter><optional>rownumber</optional></parameter>      </paramdef>     
</funcprototype>    </funcsynopsis>    <para>     
<function>ovrimos_fetch_into</function> lit une ligne dans un r&eacute;sultat SQL.    
</para>    <para>     <function>ovrimos_fetch_into</function> lit une ligne dans le    
 r&eacute;sultat <parameter>result_id</parameter>, qui doit &ecirc;tre pass&eacute;    
 en r&eacute;f&eacute;rence. La ligne qui sera lue est d&eacute;termin&eacute;e par 
les deux     param&egrave;tres <parameter><optional>how</optional></parameter> et     
<parameter><optional>rownumber</optional></parameter>.      
<parameter><optional>how</optional></parameter> peut prendre les valeurs de     'Next' 
(suivant, valeur par d&eacute;faut), 'Prev' (pr&eacute;c&eacute;dent),     'First' 
(premier), 'Last' (dernier), 'Absolute' (position absolue). La      casse de  
<parameter><optional>how</optional></parameter>     n'est pas prise en compte. 
<parameter><optional>rownumber</optional></parameter>     est optionnel, sauf dans le 
cas d''Absolute'.     <function>ovrimos_fetch_into</function> retourne &true; ou 
&false;.    </para>    <para>     <example>      <title>Lit un exemple</title>      
<programlisting role="php">&lt;?php$conn=ovrimos_connect("neptune", "8001", "admin", 
"password");if ($conn!=0) {    echo "Connection &eacute;tablie!";    
$res=ovrimos_exec($conn,"SELECT table_id, table_name FROM sys.tables");    if ($res != 
0) {        echo "Requ&ecirc;te effectu&eacute;e!";        if 
(ovrimos_fetch_into($res, &amp;$row)) {            list ($table_id, $table_name) = 
$row;            echo "table_id=".$table_id.", table_name=".$table_name."\n";          
  if (ovrimos_fetch_into($res, &amp;$row)) {                list ($table_id, 
$table_name) = $row;                echo "table_id=".$table_id.", 
table_name=".$table_name."\n";            } else {                echo "Next: 
erreur\n";            }        } else {            echo "First: erreur\n";        }    
    ovrimos_free_result($res);    }    ovrimos_close($conn);}?&gt;      
</programlisting>     </example>     Cet exemple lis une ligne.    </para>   
</refsect1>  </refentry>  <refentry id="function.ovrimos-fetch-row">   <refnamediv>    
<refname>ovrimos_fetch_row</refname>    <refpurpose>Lit une ligne dans un 
r&eacute;sultat</refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>boolean 
<function>ovrimos_fetch_row</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>      <paramdef>int       
<parameter><optional>how</optional></parameter>      </paramdef>      <paramdef>int    
   <parameter><optional>row_number</optional></parameter>      </paramdef>     
</funcprototype>    </funcsynopsis>    <para>     
<function>ovrimos_fetch_row</function> lit une ligne dans un r&eacute;sultat SQL.    
</para>    <para>     <function>ovrimos_fetch_row</function> lit une ligne dans un 
r&eacute;sultat.     Les colonnes doivent &ecirc;tre lues par un autre appel. Retourne 
&true; en     cas de succ¸s et &false; sinon.    </para>    <para>     <example>      
<title>Exemple de lecture de ligne</title>      <programlisting 
role="php">&lt;?php$conn = ovrimos_connect("remote.host", "8001", "admin", 
"password");if ($conn != 0) {    echo "Connection &eacute;tablie!";    
$res=ovrimos_exec($conn, "select table_id, table_name from sys.tables");    if ($res 
!= 0) {        echo "Requ&ecirc;te effectu&eacute;e!";        if 
(ovrimos_fetch_row($res, "First")) {            $table_id = ovrimos_result($res, 1);   
         $table_name = ovrimos_result($res, 2);            echo 
"table_id=".$table_id.", table_name=".$table_name."\n";            if 
(ovrimos_fetch_row($res, "Next")) {                $table_id = ovrimos_result($res, 
"table_id");                $table_name = ovrimos_result($res, "table_name");          
      echo "table_id=".$table_id.", table_name=".$table_name."\n";            } else { 
               echo "Next: erreur\n";            }        } else {            echo 
"First: erreur\n";        }        ovrimos_free_result($res);    }    
ovrimos_close($conn);}?&gt;      </programlisting>     </example>     Cet exemple lit 
une ligne et l'affiche.    </para>   </refsect1>  </refentry>  <refentry 
id="function.ovrimos-result">   <refnamediv>    <refname>ovrimos_result</refname>    
<refpurpose>Lit le contenu d'une colonne</refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_result</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>      <paramdef>mixed 
<parameter>field</parameter></paramdef>     </funcprototype>    </funcsynopsis>    
<para>     <function>ovrimos_result</function> sert &agrave; lire le contenu de l;a    
 colonne <parameter>field</parameter> dans le rˇsultat      
<parameter>result_id</parameter>.    </para>    <para>     
<function>ovrimos_result</function> lit le contenu de la colonne     
<parameter>field</parameter> dans le r&eacute;sultat      
<parameter>result_id</parameter>. <parameter>field</parameter> peut      &ecirc;tre le 
nom de la colonne (une cha&icirc;ne) ou bien le num&eacute;ro     de la colonne (la 
premi&egrave;re colonne est alors 1).    </para>    </refsect1>  </refentry>  
<refentry id="function.ovrimos-result-all">   <refnamediv>    
<refname>ovrimos_result_all</refname>    <refpurpose>     Affiche un r&eacute;sultat 
sous forme de table HTML    </refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>boolean 
<function>ovrimos_result_all</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>      <paramdef>string       
<parameter><optional>format</optional></parameter>      </paramdef>     
</funcprototype>    </funcsynopsis>    <para>     
<function>ovrimos_result_all</function> sert &agrave; afficher tout le r&eacute;sultat 
    d'une requ&ecirc;te.    </para>    <para>     
<function>ovrimos_result_all</function> affiche le r&eacute;sultat de la requ&ecirc;te 
    repr&eacute;sent&eacute;e par <parameter>result_id</parameter>.     
<function>ovrimos_result_all</function> retourne &true; ou &false;.    </para>    
<para>     <example>      <title>Pr&eacute;pare une requ&ecirc;te, 
l'&eacute;x&eacute;cute, et affiche le r&eacute;sultat</title>      <programlisting 
role="php">&lt;?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if 
($conn != 0) {    echo "Connection &eacute;tablie!";    $res = ovrimos_prepare($conn, 
"select table_id, table_name                                    from sys.tables where 
table_id = 7");    if ($res != 0) {        echo "Pr&eacute;paration faite!";        if 
(ovrimos_execute($res, array(3))) {            echo "Ex&eacute;cution 
r&eacute;ussie!\n";            ovrimos_result_all($res);        } else {            
echo "Ex&eacute;cution manqu&eacute;e!";        }        ovrimos_free_result($res);    
} else {        echo "Pr&eacute;paration manqu&eacute;e!\n";    }    
ovrimos_close($conn);}?&gt;      </programlisting>     </example>     Cet exemple 
ex&eacute;cute une requ&ecirc;te SQL et affiche le r&eacute;sultat sous forme     
d'une table HTML.    </para>    <para>     <example>      
<title><function>ovrimos_result_all</function> avec meta-information</title>      
<programlisting role="php">&lt;?php$conn = ovrimos_connect("db_host", "8001", "admin", 
"password");if ($conn != 0) {    echo "Connection &eacute;tablie!";    $res = 
ovrimos_exec($conn, "select table_id, table_name                                 from 
sys.tables where table_id = 1")    if ($res != 0) {        echo "Requ&ecirc;te 
effectu&eacute;e! cursor=".ovrimos_cursor($res)."\n";        $colnb = 
ovrimos_num_fields($res);        echo "Output columns=".$colnb."\n";        for ($i=1; 
$i&lt;=$colnb; $i++) {            $name = ovrimos_field_name($res, $i);            
$type = ovrimos_field_type($res, $i);            $len = ovrimos_field_len($res, $i);   
         echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n";       
 }        ovrimos_result_all($res);        ovrimos_free_result($res);    }    
ovrimos_close($conn);}?&gt;      </programlisting>     </example>    </para>    <para> 
    <example>      <title>Exemple avec <function>ovrimos_result_all</function></title> 
     <programlisting role="php">&lt;?php$conn = ovrimos_connect("db_host", "8001", 
"admin", "password");if ($conn != 0) {    echo "Connection &eacute;tablie!";    $res = 
ovrimos_exec($conn, "update test set i=5");    if ($res != 0) {        echo 
"Requ&ecirc;te effectu&eacute;e!";        echo ovrimos_num_rows($res)." lignes 
affect&eacute;es\n";        ovrimos_free_result($res);    }    
ovrimos_close($conn);}?&gt;      </programlisting>     </example>    </para>   
</refsect1>  </refentry>  <refentry id="function.ovrimos-num-rows">   <refnamediv>    
<refname>ovrimos_num_rows</refname>    <refpurpose>     Retourne le nombre de lignes 
affect&eacute;es par une modification    </refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_num_rows</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>     </funcprototype>    </funcsynopsis>    
<para>     <function>ovrimos_num_rows</function> retourne le nombre de lignes     
affect&eacute;es par une modification    </para>   </refsect1>  </refentry>  <refentry 
id="function.ovrimos-num-fields">   <refnamediv>    
<refname>ovrimos_num_fields</refname>    <refpurpose>Retourne le nombre de 
colonnes</refpurpose>   </refnamediv>   <refsect1>    <title>Description</title>    
<funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_num_fields</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>     </funcprototype>    </funcsynopsis>    
<para>     <function>ovrimos_num_fields</function> indique le nombre de colonnes     
du r&eacute;sultat <parameter>result_id</parameter>.    </para>   </refsect1>  
</refentry>  <refentry id="function.ovrimos-field-name">   <refnamediv>    
<refname>ovrimos_field_name</refname>    <refpurpose>Retourne le nom d'une 
colonne</refpurpose>   </refnamediv>   <refsect1>    <title>Description</title>    
<funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_field_name</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>      <paramdef>int 
<parameter>field_number</parameter></paramdef>     </funcprototype>    </funcsynopsis> 
   <para>     <function>ovrimos_field_name</function> sert &agrave; obtenir le nom 
d'une     colonne.    </para>    <para>     <function>ovrimos_field_name</function> 
retourne le nom d'une colonne     &agrave; partir de son num&eacute;ro de colonne 
<parameter>field_number</parameter>,     (la premi&egrave;re colonne est &agrave; 1).  
  </para>   </refsect1>  </refentry>  <refentry id="function.ovrimos-field-type">   
<refnamediv>    <refname>ovrimos_field_type</refname>    <refpurpose>     Retourne le 
type num&eacute;rique d'une colonne    </refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_field_type</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>      <paramdef>int 
<parameter>field_number</parameter></paramdef>     </funcprototype>    </funcsynopsis> 
   <para>     <function>ovrimos_field_type</function> sert &agrave; conna&icirc;tre le 
type     num&eacute;rique d'une colonne.    </para>    <para>     
<function>ovrimos_field_type</function> retourne le type num&eacute;rique     d'une 
colonne, identifi&eacute;e par son num&eacute;ro <parameter>field_number</parameter>   
  dans le r&eacute;sultat <parameter>field_number</parameter>.    </para>    
</refsect1>  </refentry>  <refentry id="function.ovrimos-field-len">   <refnamediv>    
<refname>ovrimos_field_len</refname>    <refpurpose>Retourne la taille d'une 
colonne</refpurpose>   </refnamediv>   <refsect1>    <title>Description</title>    
<funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_field_len</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>      <paramdef>int 
<parameter>field_number</parameter></paramdef>     </funcprototype>    </funcsynopsis> 
   <para>     <function>ovrimos_field_len</function> sert &agrave; conna&icirc;tre la 
taille     d'une colonne.    </para>    <para>     
<function>ovrimos_field_len</function> retourne la taille de la     colonne 
<parameter>field_number</parameter>, dans le r&eacute;sultat     
<parameter>field_number</parameter>.    </para>    </refsect1>  </refentry>  <refentry 
id="function.ovrimos-field-num">   <refnamediv>    
<refname>ovrimos_field_num</refname>    <refpurpose>Retourne le num&eacute;ro de 
colonne</refpurpose>   </refnamediv>   <refsect1>    <title>Description</title>    
<funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_field_num</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>      <paramdef>string 
<parameter>field_name</parameter></paramdef>     </funcprototype>    </funcsynopsis>   
 <para>     <function>ovrimos_field_num</function> sert &agrave; conna&icirc;tre le 
nu&eacute;mro de     colonne, &agrave; partir de son nom.    </para>    <para>     
<function>ovrimos_field_num</function> retourne le num&eacute;ro de la colonne      
<parameter>field_name</parameter> (la num&eacute;rotation commence &agrave; 1), dans   
   <parameter>result_id</parameter>.    </para>   </refsect1>  </refentry>  <refentry 
id="function.ovrimos-free-result">   <refnamediv>    
<refname>ovrimos_free_result</refname>    <refpurpose>Lib&egrave;re les ressources 
utilis&eacute;es par un r&eacute;sultat</refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_free_result</function></funcdef>      <paramdef>int 
<parameter>result_id</parameter></paramdef>     </funcprototype>    </funcsynopsis>    
<para>     <function>ovrimos_free_result</function> sert &agrave; effacer un 
r&eacute;sultat.    </para>    <para>     <function>ovrimos_free_result</function> 
lib&egrave;re toutes les     ressources prises par le r&eacute;sultat 
<parameter>result_id</parameter>.     <function>ovrimos_free_result</function> 
retourne &true;.    </para>    </refsect1>  </refentry>  <refentry 
id="function.ovrimos-commit">   <refnamediv>    <refname>ovrimos_commit</refname>    
<refpurpose>Valide une transaction</refpurpose>   </refnamediv>   <refsect1>    
<title>Description</title>    <funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_commit</function></funcdef>      <paramdef>int 
<parameter>connection_id</parameter></paramdef>     </funcprototype>    
</funcsynopsis>    <para>     <function>ovrimos_commit</function> sert &agrave; 
ex&eacute;cuter une     transaction.    </para>    <para>     
<function>ovrimos_commit</function> ex&eacute;cute la transaction 
pr&eacute;par&eacute;e     sur la connexion <parameter>connection_id</parameter>.    
</para>    </refsect1>  </refentry>  <refentry id="function.ovrimos-rollback">   
<refnamediv>    <refname>ovrimos_rollback</refname>    <refpurpose>Annule une 
transaction</refpurpose>   </refnamediv>   <refsect1>    <title>Description</title>    
<funcsynopsis>     <funcprototype>      <funcdef>int 
<function>ovrimos_rollback</function></funcdef>      <paramdef>int 
<parameter>connection_id</parameter></paramdef>     </funcprototype>    
</funcsynopsis>    <para>     <function>ovrimos_rollback</function> sert &agrave; 
annuler une transaction.    </para>    <para>     
<function>ovrimos_rollback</function> annule la transaction pr&eacute;par&eacute;e sur 
    la connexion <parameter>connection_id</parameter>.    </para>    </refsect1>  
</refentry> </reference><!-- Keep this comment at the end of the fileLocal 
variables:mode: 
sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tsgml-parent-document:nilsgml-default-dtd-file:"../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:-->
\ No newline at end of file
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.7 $ -->
+<reference id="ref.ovrimos">
+  <title>Ovrimos SQL</title>
+  <titleabbrev>OvrimosSQL</titleabbrev>
+  <partintro>
+   <para>
+    Ovrimos SQL Server est une base de donn&eacute;es relationnelle client/serveur
+    et transactionnelle, combin&eacute;e avec des fonctionnalit&eacute;s web, et des
+    transactions rapides.
+   </para>
+   <para>
+    Ovrimos SQL Server est disponible &agrave; <ulink
+    url="&url.ovrimos;">www.ovrimos.com</ulink>.  Pour activer le support
+    ovrimos de PHP, il suffit de compiler PHP avec l'option
+    <link linkend="install.configure.with-ovrimos"><option 
+role="configure">--with-ovrimos</option></link>
+    du script de configuration. Vous devrez aussi installer la librairie sqlcli
+    disponible avec la distribution Ovrimos SQL Server.
+   </para>
+   <para>
+    <example>
+     <title>
+      Connection au serveur Ovrimos SQL Server et s&eacute;lection d'une table 
+syst&egrave;me
+     </title>
+     <programlisting role="php">
+&lt;?php
+$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");
+if ($conn != 0) {
+    echo ("Connection &eacute;tablie!");
+    $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables");
+    if ($res != 0) {
+        echo "Requ&ecirc;te effectu&eacute;e!";
+        ovrimos_result_all($res);
+        ovrimos_free_result($res);
+    }
+    ovrimos_close($conn);
+}
+?&gt;
+     </programlisting>
+    </example>
+    Cet exemple effectue une connexion r&eacute;ussie.
+   </para>
+  </partintro>
+  <refentry id="function.ovrimos-connect">
+   <refnamediv>
+    <refname>ovrimos_connect</refname>
+    <refpurpose>Connexion &agrave; un serveur</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_connect</function></funcdef>
+      <paramdef>string <parameter>host</parameter></paramdef>
+      <paramdef>string <parameter>db</parameter></paramdef>
+      <paramdef>string <parameter>user</parameter></paramdef>
+      <paramdef>string <parameter>password</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_connect</function> sert &agrave; se connecter &agrave; un 
+serveur
+     Ovrimos.
+    </para>
+    <para>
+     <function>ovrimos_connect</function> retourne un identifiant de connexion,
+     sup&eacute;rieur &agrave; 0, ou 0 en cas 
+d'&eacute;chec.<parameter>host</parameter>
+     est l'adresse IP de l'h&ocirc;te Ovrimos, et <parameter>db</parameter> est soit
+     le nom d'une base de donn&eacute;es, soit une cha&icirc;ne contenant 
+     le num&eacute;ro de port.
+    </para>
+    <para>
+     <example>
+      <title>Exemple avec <function>ovrimos_connect</function></title>
+      <programlisting role="php">
+&lt;?php
+$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");
+if ($conn != 0) {
+    echo "Connection &eacute;tablie!";
+    $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables");
+    if ($res != 0) {
+        echo "Requ&ecirc;te effectu&eacute;e!";
+        ovrimos_result_all($res);
+        ovrimos_free_result($res);
+    }
+    ovrimos_close($conn);
+}
+?&gt;
+      </programlisting>
+     </example>
+     L'exemple ci-dessus montre comment se connecter &agrave; une base de 
+donn&eacute;es
+     et afficher le contenu d'une table.
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-close">
+   <refnamediv>
+    <refname>ovrimos_close</refname>
+    <refpurpose>Ferme une connexion</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>void <function>ovrimos_close</function></funcdef>
+      <paramdef>int <parameter>connection</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_close</function> sert &agrave; ferme une connexion
+     &agrave; un serveur Ovrimos.
+    </para>
+    <para>
+     <function>ovrimos_close</function> ferme la connexion au serveur
+     Ovrimos. Toutes les transactions non valid&eacute;es sont annul&eacute;es.
+    </para>
+   </refsect1>
+  </refentry>
+<!--
+  <refentry id="function.ovrimos-close-all">
+   <refnamediv>
+    <refname>ovrimos_close_all</refname>
+    <refpurpose>Ferme toutes les connexions aux serveurs ovrimos</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>void <function>ovrimos_close_all</function></funcdef>
+      <paramdef>void</paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_close_all</function> sert &agrave; ferme toutes les connexions.
+    </para>
+    <para>
+     <function>ovrimos_close_all</function> ferme toute les connexions &agrave;
+     Ovrimos. Toutes les transactions non valid&eacute;es sont annul&eacute;es.
+    </para>
+   </refsect1>
+  </refentry>
+-->
+  <refentry id="function.ovrimos-longreadlen">
+   <refnamediv>
+    <refname>ovrimos_longreadlen</refname>
+    <refpurpose>
+     Indique la taille des donn&eacute;es &agrave; lire dans une colonne de grande 
+taille
+    </refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_longreadlen</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>int <parameter>length</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_longreadlen</function> sert &agrave; lire la taille des
+     donn&eacute;es qui sera lues lors de l'acc&egrave;s une colonne de grande taille.
+    </para>
+    <para>
+     <function>ovrimos_longreadlen</function> indique le nombre d'octets
+     qui seront lus dans une colonne de grande taille (long varchar et long
+     varbinary). Par d&eacute;faut, 0. Ind&eacute;pendemment du fait que
+     <function>ovrimos_longreadlen</function> requiert 
+<parameter>result_id</parameter>,
+     actuellement <function>ovrimos_longreadlen</function> affecte ce param&egrave;tre
+     pour tous les r&eacute;sultats.
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-prepare">
+   <refnamediv>
+    <refname>ovrimos_prepare</refname>
+    <refpurpose>Pr&eacute;pare une requ&ecirc;te SQL</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_prepare</function></funcdef>
+      <paramdef>int <parameter>connection_id</parameter></paramdef>
+      <paramdef>string <parameter>query</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_prepare</function> sert &agrave; pr&eacute;parer une 
+requ&ecirc;te SQL.
+    </para>
+    <para>
+     <function>ovrimos_prepare</function> pr&eacute;pare une requ&ecirc;te SQL
+     et retourne un identifiant de r&eacute;sultat result_id (ou &false; en cas 
+d'&eacute;chec).
+    </para>
+   <para>
+    <example>
+     <title>
+      Connexion &agrave; un serveur Ovrimos SQL Server et pr&eacute;paration 
+      d'une requ&ecirc;te
+     </title>
+     <programlisting role="php">
+&lt;?php
+$conn=ovrimos_connect("db_host", "8001", "admin", "password");
+if ($conn!=0) {
+    echo "Connection &eacute;tablie!";
+    $res=ovrimos_prepare($conn, "select table_id, table_name
+                                  from sys.tables where table_id=1");
+    if ($res != 0) {
+        echo "Pr&eacute;paration faite!";
+        if (ovrimos_execute($res)) {
+            echo "Ex&eacute;cution r&eacute;ussie!\n";
+            ovrimos_result_all($res);
+        } else {
+            echo "Ex&eacute;cution manqu&eacute;e!";
+        }
+        ovrimos_free_result($res);
+    } else {
+        echo "Pr&eacute;paration manqu&eacute;e!\n";
+    }
+    ovrimos_close($conn);
+}
+?&gt;
+      </programlisting>
+     </example>
+     Cet exemple montre comment se connecter &agrave; un serveur Ovrimos SQL Server,
+     comment pr&eacute;parer une requ&ecirc;te SQL et l'ex&eacute;cuter.
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-execute">
+   <refnamediv>
+    <refname>ovrimos_execute</refname>
+    <refpurpose>Ex&eacute;cute une requ&ecirc;te pr&eacute;par&eacute;e</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>boolean <function>ovrimos_execute</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>array
+       <parameter><optional>parameters_array</optional></parameter>
+      </paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_execute</function> sert &agrave; ex&eacute;cuter une 
+requ&ecirc;te SQL.
+    </para>
+    <para>
+     <function>ovrimos_execute</function> ex&eacute;cute une requ&ecirc;te
+     pr&eacute;par&eacute;e. <function>ovrimos_execute</function>
+     retourne &true; ou &false;. Si la requ&ecirc;te pr&eacute;par&eacute;e
+     contient des param&egrave;tres (des points d'interrogations dans la
+     requ&ecirc;te), un nombre correct de param&egrave;tre doit &ecirc;tre
+     pass&eacute; dans le tableau <parameter>parameters_array</parameter>. Notez
+     que <function>ovrimos_execute</function> ne
+     suit pas les conventions PHP qui placent les noms des param&egrave;tres
+     entre crochets. L'auteur n'a pas pu s'y faire.
+    </para>
+    </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-cursor">
+   <refnamediv>
+    <refname>ovrimos_cursor</refname>
+    <refpurpose>Retourne le nom du curseur</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_cursor</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_cursor</function> sert &agrave; lire le nom du curseur
+     </para>
+    <para>
+     <function>ovrimos_cursor</function> retourne le nom du curseur.
+     Pratique, lorsqu'on veut faire des modifications ou des effacements
+     avec des curseurs d&eacute;j&agrave; positionn&eacute;s.
+    </para>
+    </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-exec">
+   <refnamediv>
+    <refname>ovrimos_exec</refname>
+    <refpurpose>Ex&eacute;cute une requ&ecirc;te SQL</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_exec</function></funcdef>
+      <paramdef>int <parameter>connection_id</parameter></paramdef>
+      <paramdef>string <parameter>query</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_exec</function> sert &agrave; ex&eacute;cuter une
+     requ&ecirc;te SQL.
+    </para>
+    <para>
+     <function>ovrimos_exec</function> ex&eacute;cute une requ&ecirc;te SQL
+     (selection ou modification), et retourne un identifiant de r&eacute;sultat
+     result_id (ou bien &false;, en cas d'&eacute;chec).  Evidemment, la
+     requ&ecirc;te SQL ne doit pas contenir de param&egrave;tres.
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-fetch-into">
+   <refnamediv>
+    <refname>ovrimos_fetch_into</refname>
+    <refpurpose>Lit une ligne dans un r&eacute;sultat</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>boolean <function>ovrimos_fetch_into</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>array <parameter>result_array</parameter></paramdef>
+      <paramdef>string
+       <parameter><optional>how</optional></parameter>
+      </paramdef>
+      <paramdef>int
+       <parameter><optional>rownumber</optional></parameter>
+      </paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_fetch_into</function> lit une ligne dans un r&eacute;sultat 
+SQL.
+    </para>
+    <para>
+     <function>ovrimos_fetch_into</function> lit une ligne dans le
+     r&eacute;sultat <parameter>result_id</parameter>, qui doit &ecirc;tre 
+pass&eacute;
+     en r&eacute;f&eacute;rence. La ligne qui sera lue est d&eacute;termin&eacute;e 
+par les deux
+     param&egrave;tres <parameter><optional>how</optional></parameter> et
+     <parameter><optional>rownumber</optional></parameter>.
+      <parameter><optional>how</optional></parameter> peut prendre les valeurs de
+     'Next' (suivant, valeur par d&eacute;faut), 'Prev' (pr&eacute;c&eacute;dent),
+     'First' (premier), 'Last' (dernier), 'Absolute' (position absolue). La 
+     casse de  <parameter><optional>how</optional></parameter>
+     n'est pas prise en compte. <parameter><optional>rownumber</optional></parameter>
+     est optionnel, sauf dans le cas d''Absolute'.
+     <function>ovrimos_fetch_into</function> retourne &true; ou &false;.
+    </para>
+    <para>
+     <example>
+      <title>Lit un exemple</title>
+      <programlisting role="php">
+&lt;?php
+$conn=ovrimos_connect("neptune", "8001", "admin", "password");
+if ($conn!=0) {
+    echo "Connection &eacute;tablie!";
+    $res=ovrimos_exec($conn,"SELECT table_id, table_name FROM sys.tables");
+    if ($res != 0) {
+        echo "Requ&ecirc;te effectu&eacute;e!";
+        if (ovrimos_fetch_into($res, &amp;$row)) {
+            list ($table_id, $table_name) = $row;
+            echo "table_id=".$table_id.", table_name=".$table_name."\n";
+            if (ovrimos_fetch_into($res, &amp;$row)) {
+                list ($table_id, $table_name) = $row;
+                echo "table_id=".$table_id.", table_name=".$table_name."\n";
+            } else {
+                echo "Next: erreur\n";
+            }
+        } else {
+            echo "First: erreur\n";
+        }
+        ovrimos_free_result($res);
+    }
+    ovrimos_close($conn);
+}
+?&gt;
+      </programlisting>
+     </example>
+     Cet exemple lis une ligne.
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-fetch-row">
+   <refnamediv>
+    <refname>ovrimos_fetch_row</refname>
+    <refpurpose>Lit une ligne dans un r&eacute;sultat</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>boolean <function>ovrimos_fetch_row</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>int
+       <parameter><optional>how</optional></parameter>
+      </paramdef>
+      <paramdef>int
+       <parameter><optional>row_number</optional></parameter>
+      </paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_fetch_row</function> lit une ligne dans un r&eacute;sultat SQL.
+    </para>
+    <para>
+     <function>ovrimos_fetch_row</function> lit une ligne dans un r&eacute;sultat.
+     Les colonnes doivent &ecirc;tre lues par un autre appel. Retourne &true; en
+     cas de succ&egrave;s et &false; sinon.
+    </para>
+    <para>
+     <example>
+      <title>Exemple de lecture de ligne</title>
+      <programlisting role="php">
+&lt;?php
+$conn = ovrimos_connect("remote.host", "8001", "admin", "password");
+if ($conn != 0) {
+    echo "Connection &eacute;tablie!";
+    $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables");
+    if ($res != 0) {
+        echo "Requ&ecirc;te effectu&eacute;e!";
+        if (ovrimos_fetch_row($res, "First")) {
+            $table_id = ovrimos_result($res, 1);
+            $table_name = ovrimos_result($res, 2);
+            echo "table_id=".$table_id.", table_name=".$table_name."\n";
+            if (ovrimos_fetch_row($res, "Next")) {
+                $table_id = ovrimos_result($res, "table_id");
+                $table_name = ovrimos_result($res, "table_name");
+                echo "table_id=".$table_id.", table_name=".$table_name."\n";
+            } else {
+                echo "Next: erreur\n";
+            }
+        } else {
+            echo "First: erreur\n";
+        }
+        ovrimos_free_result($res);
+    }
+    ovrimos_close($conn);
+}
+?&gt;
+      </programlisting>
+     </example>
+     Cet exemple lit une ligne et l'affiche.
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-result">
+   <refnamediv>
+    <refname>ovrimos_result</refname>
+    <refpurpose>Lit le contenu d'une colonne</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_result</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>mixed <parameter>field</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_result</function> sert &agrave; lire le contenu de l;a
+     colonne <parameter>field</parameter> dans le r&eacute;sultat 
+     <parameter>result_id</parameter>.
+    </para>
+    <para>
+     <function>ovrimos_result</function> lit le contenu de la colonne
+     <parameter>field</parameter> dans le r&eacute;sultat 
+     <parameter>result_id</parameter>. <parameter>field</parameter> peut 
+     &ecirc;tre le nom de la colonne (une cha&icirc;ne) ou bien le num&eacute;ro
+     de la colonne (la premi&egrave;re colonne est alors 1).
+    </para>
+    </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-result-all">
+   <refnamediv>
+    <refname>ovrimos_result_all</refname>
+    <refpurpose>
+     Affiche un r&eacute;sultat sous forme de table HTML
+    </refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>boolean <function>ovrimos_result_all</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>string
+       <parameter><optional>format</optional></parameter>
+      </paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_result_all</function> sert &agrave; afficher tout le 
+r&eacute;sultat
+     d'une requ&ecirc;te.
+    </para>
+    <para>
+     <function>ovrimos_result_all</function> affiche le r&eacute;sultat de la 
+requ&ecirc;te
+     repr&eacute;sent&eacute;e par <parameter>result_id</parameter>.
+     <function>ovrimos_result_all</function> retourne &true; ou &false;.
+    </para>
+    <para>
+     <example>
+      <title>Pr&eacute;pare une requ&ecirc;te, l'&eacute;x&eacute;cute, et affiche le 
+r&eacute;sultat</title>
+      <programlisting role="php">
+&lt;?php
+$conn = ovrimos_connect("db_host", "8001", "admin", "password");
+if ($conn != 0) {
+    echo "Connection &eacute;tablie!";
+    $res = ovrimos_prepare($conn, "select table_id, table_name
+                                    from sys.tables where table_id = 7");
+    if ($res != 0) {
+        echo "Pr&eacute;paration faite!";
+        if (ovrimos_execute($res, array(3))) {
+            echo "Ex&eacute;cution r&eacute;ussie!\n";
+            ovrimos_result_all($res);
+        } else {
+            echo "Ex&eacute;cution manqu&eacute;e!";
+        }
+        ovrimos_free_result($res);
+    } else {
+        echo "Pr&eacute;paration manqu&eacute;e!\n";
+    }
+    ovrimos_close($conn);
+}
+?&gt;
+      </programlisting>
+     </example>
+     Cet exemple ex&eacute;cute une requ&ecirc;te SQL et affiche le r&eacute;sultat 
+sous forme
+     d'une table HTML.
+    </para>
+    <para>
+     <example>
+      <title><function>ovrimos_result_all</function> avec meta-information</title>
+      <programlisting role="php">
+&lt;?php
+$conn = ovrimos_connect("db_host", "8001", "admin", "password");
+if ($conn != 0) {
+    echo "Connection &eacute;tablie!";
+    $res = ovrimos_exec($conn, "select table_id, table_name
+                                 from sys.tables where table_id = 1")
+    if ($res != 0) {
+        echo "Requ&ecirc;te effectu&eacute;e! cursor=".ovrimos_cursor($res)."\n";
+        $colnb = ovrimos_num_fields($res);
+        echo "Output columns=".$colnb."\n";
+        for ($i=1; $i&lt;=$colnb; $i++) {
+            $name = ovrimos_field_name($res, $i);
+            $type = ovrimos_field_type($res, $i);
+            $len = ovrimos_field_len($res, $i);
+            echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n";
+        }
+        ovrimos_result_all($res);
+        ovrimos_free_result($res);
+    }
+    ovrimos_close($conn);
+}
+?&gt;
+      </programlisting>
+     </example>
+    </para>
+    <para>
+     <example>
+      <title>Exemple avec <function>ovrimos_result_all</function></title>
+      <programlisting role="php">
+&lt;?php
+$conn = ovrimos_connect("db_host", "8001", "admin", "password");
+if ($conn != 0) {
+    echo "Connection &eacute;tablie!";
+    $res = ovrimos_exec($conn, "update test set i=5");
+    if ($res != 0) {
+        echo "Requ&ecirc;te effectu&eacute;e!";
+        echo ovrimos_num_rows($res)." lignes affect&eacute;es\n";
+        ovrimos_free_result($res);
+    }
+    ovrimos_close($conn);
+}
+?&gt;
+      </programlisting>
+     </example>
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-num-rows">
+   <refnamediv>
+    <refname>ovrimos_num_rows</refname>
+    <refpurpose>
+     Retourne le nombre de lignes affect&eacute;es par une modification
+    </refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_num_rows</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_num_rows</function> retourne le nombre de lignes
+     affect&eacute;es par une modification
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-num-fields">
+   <refnamediv>
+    <refname>ovrimos_num_fields</refname>
+    <refpurpose>Retourne le nombre de colonnes</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_num_fields</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_num_fields</function> indique le nombre de colonnes
+     du r&eacute;sultat <parameter>result_id</parameter>.
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-field-name">
+   <refnamediv>
+    <refname>ovrimos_field_name</refname>
+    <refpurpose>Retourne le nom d'une colonne</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_field_name</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>int <parameter>field_number</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_field_name</function> sert &agrave; obtenir le nom d'une
+     colonne.
+    </para>
+    <para>
+     <function>ovrimos_field_name</function> retourne le nom d'une colonne
+     &agrave; partir de son num&eacute;ro de colonne 
+<parameter>field_number</parameter>,
+     (la premi&egrave;re colonne est &agrave; 1).
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-field-type">
+   <refnamediv>
+    <refname>ovrimos_field_type</refname>
+    <refpurpose>
+     Retourne le type num&eacute;rique d'une colonne
+    </refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_field_type</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>int <parameter>field_number</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_field_type</function> sert &agrave; conna&icirc;tre le type
+     num&eacute;rique d'une colonne.
+    </para>
+    <para>
+     <function>ovrimos_field_type</function> retourne le type num&eacute;rique
+     d'une colonne, identifi&eacute;e par son num&eacute;ro 
+<parameter>field_number</parameter>
+     dans le r&eacute;sultat <parameter>field_number</parameter>.
+    </para>
+    </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-field-len">
+   <refnamediv>
+    <refname>ovrimos_field_len</refname>
+    <refpurpose>Retourne la taille d'une colonne</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_field_len</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>int <parameter>field_number</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_field_len</function> sert &agrave; conna&icirc;tre la taille
+     d'une colonne.
+    </para>
+    <para>
+     <function>ovrimos_field_len</function> retourne la taille de la
+     colonne <parameter>field_number</parameter>, dans le r&eacute;sultat
+     <parameter>field_number</parameter>.
+    </para>
+    </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-field-num">
+   <refnamediv>
+    <refname>ovrimos_field_num</refname>
+    <refpurpose>Retourne le num&eacute;ro de colonne</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_field_num</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+      <paramdef>string <parameter>field_name</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_field_num</function> sert &agrave; conna&icirc;tre le 
+nu&eacute;mro de
+     colonne, &agrave; partir de son nom.
+    </para>
+    <para>
+     <function>ovrimos_field_num</function> retourne le num&eacute;ro de la colonne
+      <parameter>field_name</parameter> (la num&eacute;rotation commence &agrave; 1), 
+dans
+      <parameter>result_id</parameter>.
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-free-result">
+   <refnamediv>
+    <refname>ovrimos_free_result</refname>
+    <refpurpose>Lib&egrave;re les ressources utilis&eacute;es par un 
+r&eacute;sultat</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_free_result</function></funcdef>
+      <paramdef>int <parameter>result_id</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_free_result</function> sert &agrave; effacer un 
+r&eacute;sultat.
+    </para>
+    <para>
+     <function>ovrimos_free_result</function> lib&egrave;re toutes les
+     ressources prises par le r&eacute;sultat <parameter>result_id</parameter>.
+     <function>ovrimos_free_result</function> retourne &true;.
+    </para>
+    </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-commit">
+   <refnamediv>
+    <refname>ovrimos_commit</refname>
+    <refpurpose>Valide une transaction</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_commit</function></funcdef>
+      <paramdef>int <parameter>connection_id</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_commit</function> sert &agrave; ex&eacute;cuter une
+     transaction.
+    </para>
+    <para>
+     <function>ovrimos_commit</function> ex&eacute;cute la transaction 
+pr&eacute;par&eacute;e
+     sur la connexion <parameter>connection_id</parameter>.
+    </para>
+    </refsect1>
+  </refentry>
+  <refentry id="function.ovrimos-rollback">
+   <refnamediv>
+    <refname>ovrimos_rollback</refname>
+    <refpurpose>Annule une transaction</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>ovrimos_rollback</function></funcdef>
+      <paramdef>int <parameter>connection_id</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>ovrimos_rollback</function> sert &agrave; annuler une transaction.
+    </para>
+    <para>
+     <function>ovrimos_rollback</function> annule la transaction 
+pr&eacute;par&eacute;e sur
+     la connexion <parameter>connection_id</parameter>.
+    </para>
+    </refsect1>
+  </refentry>
+ </reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+


Reply via email to