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>
<?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é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 :
*
* 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ées
relationnelle client/serveur et transactionnelle, combinée avec des
fonctionnalités web, et des transactions rapides. </para> <para>
Ovrimos SQL Server est disponible à <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élection d'une table système </title>
<programlisting role="php"><?php$conn = ovrimos_connect("server.domain.com",
"8001", "admin", "password");if ($conn != 0) { echo ("Connection établie!");
$res = ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if
($res != 0) { echo "Requête effectuée!";
ovrimos_result_all($res); ovrimos_free_result($res); }
ovrimos_close($conn);}?> </programlisting> </example> Cet exemple
effectue une connexion réussie. </para> </partintro> <refentry
id="function.ovrimos-connect"> <refnamediv> <refname>ovrimos_connect</refname>
<refpurpose>Connexion à 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 à se connecter à un
serveur Ovrimos. </para> <para> <function>ovrimos_connect</function>
retourne un identifiant de connexion, supérieur à 0, ou 0 en cas
d'échec.<parameter>host</parameter> est l'adresse IP de l'hôte
Ovrimos, et <parameter>db</parameter> est soit le nom d'une base de
données, soit une chaîne contenant le numéro de port.
</para> <para> <example> <title>Exemple avec
<function>ovrimos_connect</function></title> <programlisting
role="php"><?php$conn = ovrimos_connect("server.domain.com", "8001", "admin",
"password");if ($conn != 0) { echo "Connection établie!";
$res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res
!= 0) { echo "Requête effectuée!";
ovrimos_result_all($res); ovrimos_free_result($res); }
ovrimos_close($conn);}?> </programlisting> </example> L'exemple
ci-dessus montre comment se connecter à une base de donné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 à ferme une connexion
à un serveur Ovrimos. </para> <para>
<function>ovrimos_close</function> ferme la connexion au serveur Ovrimos. Toutes
les transactions non validées sont annulé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 à ferme toutes les connexions.
</para> <para> <function>ovrimos_close_all</function> ferme toute les
connexions à Ovrimos. Toutes les transactions non validées sont
annulées. </para> </refsect1> </refentry>--> <refentry
id="function.ovrimos-longreadlen"> <refnamediv>
<refname>ovrimos_longreadlen</refname> <refpurpose> Indique la taille des
données à 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 à lire la taille des
données qui sera lues lors de l'accè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éfaut, 0. Indépendemment du fait que
<function>ovrimos_longreadlen</function> requiert <parameter>result_id</parameter>,
actuellement <function>ovrimos_longreadlen</function> affecte ce paramètre
pour tous les résultats. </para> </refsect1> </refentry> <refentry
id="function.ovrimos-prepare"> <refnamediv> <refname>ovrimos_prepare</refname>
<refpurpose>Prépare une requê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 à préparer une
requête SQL. </para> <para> <function>ovrimos_prepare</function>
prépare une requête SQL et retourne un identifiant de résultat
result_id (ou &false; en cas d'échec). </para> <para> <example>
<title> Connexion à un serveur Ovrimos SQL Server et préparation
d'une requête </title> <programlisting
role="php"><?php$conn=ovrimos_connect("db_host", "8001", "admin", "password");if
($conn!=0) { echo "Connection établie!"; $res=ovrimos_prepare($conn,
"select table_id, table_name from sys.tables where
table_id=1"); if ($res != 0) { echo "Préparation faite!"; if
(ovrimos_execute($res)) { echo "Exécution réussie!\n";
ovrimos_result_all($res); } else { echo "Exécution
manquée!"; } ovrimos_free_result($res); } else { echo
"Préparation manquée!\n"; } ovrimos_close($conn);}?>
</programlisting> </example> Cet exemple montre comment se connecter à
un serveur Ovrimos SQL Server, comment préparer une requête SQL et
l'exécuter. </para> </refsect1> </refentry> <refentry
id="function.ovrimos-execute"> <refnamediv> <refname>ovrimos_execute</refname>
<refpurpose>Exécute une requête préparé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 à exécuter une requête SQL. </para> <para>
<function>ovrimos_execute</function> exécute une requête
préparée. <function>ovrimos_execute</function> retourne &true; ou
&false;. Si la requête préparée contient des paramètres
(des points d'interrogations dans la requête), un nombre correct de
paramètre doit être passé 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è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 à 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éjà positionnés. </para> </refsect1> </refentry>
<refentry id="function.ovrimos-exec"> <refnamediv>
<refname>ovrimos_exec</refname> <refpurpose>Exécute une requê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 à exécuter une
requête SQL. </para> <para> <function>ovrimos_exec</function>
exécute une requête SQL (selection ou modification), et retourne un
identifiant de résultat result_id (ou bien &false;, en cas d'échec).
Evidemment, la requête SQL ne doit pas contenir de paramètres.
</para> </refsect1> </refentry> <refentry id="function.ovrimos-fetch-into">
<refnamediv> <refname>ovrimos_fetch_into</refname> <refpurpose>Lit une ligne
dans un ré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ésultat SQL.
</para> <para> <function>ovrimos_fetch_into</function> lit une ligne dans le
résultat <parameter>result_id</parameter>, qui doit être passé
en référence. La ligne qui sera lue est déterminée par
les deux paramè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éfaut), 'Prev' (précé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"><?php$conn=ovrimos_connect("neptune", "8001", "admin",
"password");if ($conn!=0) { echo "Connection établie!";
$res=ovrimos_exec($conn,"SELECT table_id, table_name FROM sys.tables"); if ($res !=
0) { echo "Requête effectuée!"; if
(ovrimos_fetch_into($res, &$row)) { list ($table_id, $table_name) =
$row; echo "table_id=".$table_id.", table_name=".$table_name."\n";
if (ovrimos_fetch_into($res, &$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);}?>
</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é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ésultat SQL.
</para> <para> <function>ovrimos_fetch_row</function> lit une ligne dans un
résultat. Les colonnes doivent ê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"><?php$conn = ovrimos_connect("remote.host", "8001", "admin",
"password");if ($conn != 0) { echo "Connection établie!";
$res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res
!= 0) { echo "Requête effectué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);}?> </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 à 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ésultat
<parameter>result_id</parameter>. <parameter>field</parameter> peut être le
nom de la colonne (une chaîne) ou bien le numéro de la colonne (la
première colonne est alors 1). </para> </refsect1> </refentry>
<refentry id="function.ovrimos-result-all"> <refnamediv>
<refname>ovrimos_result_all</refname> <refpurpose> Affiche un ré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 à afficher tout le résultat
d'une requête. </para> <para>
<function>ovrimos_result_all</function> affiche le résultat de la requête
représentée par <parameter>result_id</parameter>.
<function>ovrimos_result_all</function> retourne &true; ou &false;. </para>
<para> <example> <title>Prépare une requête,
l'éxécute, et affiche le résultat</title> <programlisting
role="php"><?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if
($conn != 0) { echo "Connection établie!"; $res = ovrimos_prepare($conn,
"select table_id, table_name from sys.tables where
table_id = 7"); if ($res != 0) { echo "Préparation faite!"; if
(ovrimos_execute($res, array(3))) { echo "Exécution
réussie!\n"; ovrimos_result_all($res); } else {
echo "Exécution manquée!"; } ovrimos_free_result($res);
} else { echo "Préparation manquée!\n"; }
ovrimos_close($conn);}?> </programlisting> </example> Cet exemple
exécute une requête SQL et affiche le résultat sous forme
d'une table HTML. </para> <para> <example>
<title><function>ovrimos_result_all</function> avec meta-information</title>
<programlisting role="php"><?php$conn = ovrimos_connect("db_host", "8001", "admin",
"password");if ($conn != 0) { echo "Connection établie!"; $res =
ovrimos_exec($conn, "select table_id, table_name from
sys.tables where table_id = 1") if ($res != 0) { echo "Requête
effectuée! cursor=".ovrimos_cursor($res)."\n"; $colnb =
ovrimos_num_fields($res); echo "Output columns=".$colnb."\n"; for ($i=1;
$i<=$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);}?> </programlisting> </example> </para> <para>
<example> <title>Exemple avec <function>ovrimos_result_all</function></title>
<programlisting role="php"><?php$conn = ovrimos_connect("db_host", "8001",
"admin", "password");if ($conn != 0) { echo "Connection établie!"; $res =
ovrimos_exec($conn, "update test set i=5"); if ($res != 0) { echo
"Requête effectuée!"; echo ovrimos_num_rows($res)." lignes
affectées\n"; ovrimos_free_result($res); }
ovrimos_close($conn);}?> </programlisting> </example> </para>
</refsect1> </refentry> <refentry id="function.ovrimos-num-rows"> <refnamediv>
<refname>ovrimos_num_rows</refname> <refpurpose> Retourne le nombre de lignes
affecté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é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é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 à obtenir le nom
d'une colonne. </para> <para> <function>ovrimos_field_name</function>
retourne le nom d'une colonne à partir de son numéro de colonne
<parameter>field_number</parameter>, (la première colonne est à 1).
</para> </refsect1> </refentry> <refentry id="function.ovrimos-field-type">
<refnamediv> <refname>ovrimos_field_type</refname> <refpurpose> Retourne le
type numé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 à connaître le
type numérique d'une colonne. </para> <para>
<function>ovrimos_field_type</function> retourne le type numérique d'une
colonne, identifiée par son numéro <parameter>field_number</parameter>
dans le ré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 à connaî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ésultat
<parameter>field_number</parameter>. </para> </refsect1> </refentry> <refentry
id="function.ovrimos-field-num"> <refnamediv>
<refname>ovrimos_field_num</refname> <refpurpose>Retourne le numé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 à connaître le
nuémro de colonne, à partir de son nom. </para> <para>
<function>ovrimos_field_num</function> retourne le numéro de la colonne
<parameter>field_name</parameter> (la numérotation commence à 1), dans
<parameter>result_id</parameter>. </para> </refsect1> </refentry> <refentry
id="function.ovrimos-free-result"> <refnamediv>
<refname>ovrimos_free_result</refname> <refpurpose>Libère les ressources
utilisées par un ré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 à effacer un
résultat. </para> <para> <function>ovrimos_free_result</function>
libère toutes les ressources prises par le ré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 à
exécuter une transaction. </para> <para>
<function>ovrimos_commit</function> exécute la transaction
préparé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 à
annuler une transaction. </para> <para>
<function>ovrimos_rollback</function> annule la transaction préparé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ées relationnelle client/serveur
+ et transactionnelle, combinée avec des fonctionnalités web, et des
+ transactions rapides.
+ </para>
+ <para>
+ Ovrimos SQL Server est disponible à <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élection d'une table
+système
+ </title>
+ <programlisting role="php">
+<?php
+$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");
+if ($conn != 0) {
+ echo ("Connection établie!");
+ $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables");
+ if ($res != 0) {
+ echo "Requête effectuée!";
+ ovrimos_result_all($res);
+ ovrimos_free_result($res);
+ }
+ ovrimos_close($conn);
+}
+?>
+ </programlisting>
+ </example>
+ Cet exemple effectue une connexion réussie.
+ </para>
+ </partintro>
+ <refentry id="function.ovrimos-connect">
+ <refnamediv>
+ <refname>ovrimos_connect</refname>
+ <refpurpose>Connexion à 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 à se connecter à un
+serveur
+ Ovrimos.
+ </para>
+ <para>
+ <function>ovrimos_connect</function> retourne un identifiant de connexion,
+ supérieur à 0, ou 0 en cas
+d'échec.<parameter>host</parameter>
+ est l'adresse IP de l'hôte Ovrimos, et <parameter>db</parameter> est soit
+ le nom d'une base de données, soit une chaîne contenant
+ le numéro de port.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>ovrimos_connect</function></title>
+ <programlisting role="php">
+<?php
+$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");
+if ($conn != 0) {
+ echo "Connection établie!";
+ $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables");
+ if ($res != 0) {
+ echo "Requête effectuée!";
+ ovrimos_result_all($res);
+ ovrimos_free_result($res);
+ }
+ ovrimos_close($conn);
+}
+?>
+ </programlisting>
+ </example>
+ L'exemple ci-dessus montre comment se connecter à une base de
+donné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 à ferme une connexion
+ à un serveur Ovrimos.
+ </para>
+ <para>
+ <function>ovrimos_close</function> ferme la connexion au serveur
+ Ovrimos. Toutes les transactions non validées sont annulé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 à ferme toutes les connexions.
+ </para>
+ <para>
+ <function>ovrimos_close_all</function> ferme toute les connexions à
+ Ovrimos. Toutes les transactions non validées sont annulées.
+ </para>
+ </refsect1>
+ </refentry>
+-->
+ <refentry id="function.ovrimos-longreadlen">
+ <refnamediv>
+ <refname>ovrimos_longreadlen</refname>
+ <refpurpose>
+ Indique la taille des données à 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 à lire la taille des
+ données qui sera lues lors de l'accè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éfaut, 0. Indépendemment du fait que
+ <function>ovrimos_longreadlen</function> requiert
+<parameter>result_id</parameter>,
+ actuellement <function>ovrimos_longreadlen</function> affecte ce paramètre
+ pour tous les résultats.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ovrimos-prepare">
+ <refnamediv>
+ <refname>ovrimos_prepare</refname>
+ <refpurpose>Prépare une requê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 à préparer une
+requête SQL.
+ </para>
+ <para>
+ <function>ovrimos_prepare</function> prépare une requête SQL
+ et retourne un identifiant de résultat result_id (ou &false; en cas
+d'échec).
+ </para>
+ <para>
+ <example>
+ <title>
+ Connexion à un serveur Ovrimos SQL Server et préparation
+ d'une requête
+ </title>
+ <programlisting role="php">
+<?php
+$conn=ovrimos_connect("db_host", "8001", "admin", "password");
+if ($conn!=0) {
+ echo "Connection établie!";
+ $res=ovrimos_prepare($conn, "select table_id, table_name
+ from sys.tables where table_id=1");
+ if ($res != 0) {
+ echo "Préparation faite!";
+ if (ovrimos_execute($res)) {
+ echo "Exécution réussie!\n";
+ ovrimos_result_all($res);
+ } else {
+ echo "Exécution manquée!";
+ }
+ ovrimos_free_result($res);
+ } else {
+ echo "Préparation manquée!\n";
+ }
+ ovrimos_close($conn);
+}
+?>
+ </programlisting>
+ </example>
+ Cet exemple montre comment se connecter à un serveur Ovrimos SQL Server,
+ comment préparer une requête SQL et l'exécuter.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ovrimos-execute">
+ <refnamediv>
+ <refname>ovrimos_execute</refname>
+ <refpurpose>Exécute une requête préparé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 à exécuter une
+requête SQL.
+ </para>
+ <para>
+ <function>ovrimos_execute</function> exécute une requête
+ préparée. <function>ovrimos_execute</function>
+ retourne &true; ou &false;. Si la requête préparée
+ contient des paramètres (des points d'interrogations dans la
+ requête), un nombre correct de paramètre doit être
+ passé 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è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 à 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éjà positionnés.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ovrimos-exec">
+ <refnamediv>
+ <refname>ovrimos_exec</refname>
+ <refpurpose>Exécute une requê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 à exécuter une
+ requête SQL.
+ </para>
+ <para>
+ <function>ovrimos_exec</function> exécute une requête SQL
+ (selection ou modification), et retourne un identifiant de résultat
+ result_id (ou bien &false;, en cas d'échec). Evidemment, la
+ requête SQL ne doit pas contenir de paramètres.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ovrimos-fetch-into">
+ <refnamediv>
+ <refname>ovrimos_fetch_into</refname>
+ <refpurpose>Lit une ligne dans un ré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ésultat
+SQL.
+ </para>
+ <para>
+ <function>ovrimos_fetch_into</function> lit une ligne dans le
+ résultat <parameter>result_id</parameter>, qui doit être
+passé
+ en référence. La ligne qui sera lue est déterminée
+par les deux
+ paramè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éfaut), 'Prev' (précé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">
+<?php
+$conn=ovrimos_connect("neptune", "8001", "admin", "password");
+if ($conn!=0) {
+ echo "Connection établie!";
+ $res=ovrimos_exec($conn,"SELECT table_id, table_name FROM sys.tables");
+ if ($res != 0) {
+ echo "Requête effectuée!";
+ if (ovrimos_fetch_into($res, &$row)) {
+ list ($table_id, $table_name) = $row;
+ echo "table_id=".$table_id.", table_name=".$table_name."\n";
+ if (ovrimos_fetch_into($res, &$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);
+}
+?>
+ </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é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ésultat SQL.
+ </para>
+ <para>
+ <function>ovrimos_fetch_row</function> lit une ligne dans un résultat.
+ Les colonnes doivent ê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">
+<?php
+$conn = ovrimos_connect("remote.host", "8001", "admin", "password");
+if ($conn != 0) {
+ echo "Connection établie!";
+ $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables");
+ if ($res != 0) {
+ echo "Requête effectué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);
+}
+?>
+ </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 à 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ésultat
+ <parameter>result_id</parameter>. <parameter>field</parameter> peut
+ être le nom de la colonne (une chaîne) ou bien le numéro
+ de la colonne (la première colonne est alors 1).
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ovrimos-result-all">
+ <refnamediv>
+ <refname>ovrimos_result_all</refname>
+ <refpurpose>
+ Affiche un ré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 à afficher tout le
+résultat
+ d'une requête.
+ </para>
+ <para>
+ <function>ovrimos_result_all</function> affiche le résultat de la
+requête
+ représentée par <parameter>result_id</parameter>.
+ <function>ovrimos_result_all</function> retourne &true; ou &false;.
+ </para>
+ <para>
+ <example>
+ <title>Prépare une requête, l'éxécute, et affiche le
+résultat</title>
+ <programlisting role="php">
+<?php
+$conn = ovrimos_connect("db_host", "8001", "admin", "password");
+if ($conn != 0) {
+ echo "Connection établie!";
+ $res = ovrimos_prepare($conn, "select table_id, table_name
+ from sys.tables where table_id = 7");
+ if ($res != 0) {
+ echo "Préparation faite!";
+ if (ovrimos_execute($res, array(3))) {
+ echo "Exécution réussie!\n";
+ ovrimos_result_all($res);
+ } else {
+ echo "Exécution manquée!";
+ }
+ ovrimos_free_result($res);
+ } else {
+ echo "Préparation manquée!\n";
+ }
+ ovrimos_close($conn);
+}
+?>
+ </programlisting>
+ </example>
+ Cet exemple exécute une requête SQL et affiche le résultat
+sous forme
+ d'une table HTML.
+ </para>
+ <para>
+ <example>
+ <title><function>ovrimos_result_all</function> avec meta-information</title>
+ <programlisting role="php">
+<?php
+$conn = ovrimos_connect("db_host", "8001", "admin", "password");
+if ($conn != 0) {
+ echo "Connection établie!";
+ $res = ovrimos_exec($conn, "select table_id, table_name
+ from sys.tables where table_id = 1")
+ if ($res != 0) {
+ echo "Requête effectuée! cursor=".ovrimos_cursor($res)."\n";
+ $colnb = ovrimos_num_fields($res);
+ echo "Output columns=".$colnb."\n";
+ for ($i=1; $i<=$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);
+}
+?>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>ovrimos_result_all</function></title>
+ <programlisting role="php">
+<?php
+$conn = ovrimos_connect("db_host", "8001", "admin", "password");
+if ($conn != 0) {
+ echo "Connection établie!";
+ $res = ovrimos_exec($conn, "update test set i=5");
+ if ($res != 0) {
+ echo "Requête effectuée!";
+ echo ovrimos_num_rows($res)." lignes affectées\n";
+ ovrimos_free_result($res);
+ }
+ ovrimos_close($conn);
+}
+?>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ovrimos-num-rows">
+ <refnamediv>
+ <refname>ovrimos_num_rows</refname>
+ <refpurpose>
+ Retourne le nombre de lignes affecté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é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é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 à obtenir le nom d'une
+ colonne.
+ </para>
+ <para>
+ <function>ovrimos_field_name</function> retourne le nom d'une colonne
+ à partir de son numéro de colonne
+<parameter>field_number</parameter>,
+ (la première colonne est à 1).
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ovrimos-field-type">
+ <refnamediv>
+ <refname>ovrimos_field_type</refname>
+ <refpurpose>
+ Retourne le type numé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 à connaître le type
+ numérique d'une colonne.
+ </para>
+ <para>
+ <function>ovrimos_field_type</function> retourne le type numérique
+ d'une colonne, identifiée par son numéro
+<parameter>field_number</parameter>
+ dans le ré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 à connaî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ésultat
+ <parameter>field_number</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ovrimos-field-num">
+ <refnamediv>
+ <refname>ovrimos_field_num</refname>
+ <refpurpose>Retourne le numé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 à connaître le
+nuémro de
+ colonne, à partir de son nom.
+ </para>
+ <para>
+ <function>ovrimos_field_num</function> retourne le numéro de la colonne
+ <parameter>field_name</parameter> (la numérotation commence à 1),
+dans
+ <parameter>result_id</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.ovrimos-free-result">
+ <refnamediv>
+ <refname>ovrimos_free_result</refname>
+ <refpurpose>Libère les ressources utilisées par un
+ré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 à effacer un
+résultat.
+ </para>
+ <para>
+ <function>ovrimos_free_result</function> libère toutes les
+ ressources prises par le ré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 à exécuter une
+ transaction.
+ </para>
+ <para>
+ <function>ovrimos_commit</function> exécute la transaction
+préparé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 à annuler une transaction.
+ </para>
+ <para>
+ <function>ovrimos_rollback</function> annule la transaction
+préparé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:
+-->
+