cvs: phpdoc-fr /reference/ifx/functions ifx-affected-rows.xml ifx-blobinfile-mode.xml ifx-byteasvarchar.xml ifx-close.xml ifx-connect.xml
ifx-copy-blob.xml ifx-create-blob.xml ifx-create-char.xml ifx-do.xml ifx-error.xml ifx-errormsg.xml ifx-fetch-row.xml ifx-fieldproperties.xml
ifx-fieldtypes.xml ifx-free-blob.xml ifx-free-char.xml ifx-free-result.xml ifx-get-blob.xml ifx-get-char.xml ifx-getsqlca.xml

From:	Yannick Torres	Date:	Mon, 05 Feb 2007 10:59:54 +0000
Subject:	cvs: phpdoc-fr /reference/ifx/functions ifx-affected-rows.xml ifx-blobinfile-mode.xml ifx-byteasvarchar.xml ifx-close.xml ifx-connect.xml ifx-copy-blob.xml ifx-create-blob.xml ifx-create-char.xml ifx-do.xml ifx-error.xml ifx-errormsg.xml ifx-fetch-row.xml ifx-fieldproperties.xml ifx-fieldtypes.xml ifx-free-blob.xml ifx-free-char.xml ifx-free-result.xml ifx-get-blob.xml ifx-get-char.xml ifx-getsqlca.xml
Groups:	php.doc.fr
Request:	Send a blank email to doc-fr+get-5225@lists.php.net to get a copy of this message

yannick Mon Feb 5 10:59:54 2007 UTC Modified files: /phpdoc-fr/reference/ifx/functions ifx-affected-rows.xml ifx-blobinfile-mode.xml ifx-byteasvarchar.xml ifx-close.xml ifx-connect.xml ifx-copy-blob.xml ifx-create-blob.xml ifx-create-char.xml ifx-do.xml ifx-errormsg.xml ifx-error.xml ifx-fetch-row.xml ifx-fieldproperties.xml ifx-fieldtypes.xml ifx-free-blob.xml ifx-free-char.xml ifx-free-result.xml ifx-get-blob.xml ifx-get-char.xml ifx-getsqlca.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ifx/functions/ifx-affected-rows.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/ifx/functions/ifx-affected-rows.xml diff -u phpdoc-fr/reference/ifx/functions/ifx-affected-rows.xml:1.10 phpdoc-fr/reference/ifx/functions/ifx-affected-rows.xml:1.11 --- phpdoc-fr/reference/ifx/functions/ifx-affected-rows.xml:1.10 Sat May 6 18:05:10 2006 +++ phpdoc-fr/reference/ifx/functions/ifx-affected-rows.xml Mon Feb 5 10:59:53 2007 @@ -1,65 +1,99 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.ifx-affected-rows"> - <refnamediv> - <refname>ifx_affected_rows</refname> - <refpurpose> - Retourne le nombre de lignes affectées par une requête - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>ifx_affected_rows</methodname> - <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> - </methodsynopsis> - <para> - <function>ifx_affected_rows</function> retourne le nombre de lignes - affectées par la requête associée à - <parameter>result_id</parameter>. - </para> - <para> - <parameter>result_id</parameter> est un identifiant valide de résultat - retourné par <function>ifx_query</function> ou - <function>ifx_prepare</function>. - </para> - <para> - Pour les INSERT, UPDATE et DELETE, ce nombre est le nombre exact de lignes - affectées (sqlerrd[2]). Pour les SELECT, ce n'est qu'une estimation - (sqlerrd[0]). Ne vous y fiez pas. - </para> - <para> - <function>ifx_affected_rows</function> est très pratique après - <function>ifx_prepare</function> pour limiter la taille des résultats. - </para> - <para> - Voir aussi - <function>ifx_num_rows</function>. - </para> +<refentry id="function.ifx-affected-rows"> + <refnamediv> + <refname>ifx_affected_rows</refname> + <refpurpose>Retourne le nombre de lignes affectées par une requête</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>ifx_affected_rows</methodname> + <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le nombre de lignes affectées par la requête associée à + <parameter>result_id</parameter>. + </para> + <para> + Pour les INSERT, UPDATE et DELETE, ce nombre est le nombre exact de lignes + affectées (sqlerrd[2]). Pour les SELECT, ce n'est qu'une estimation + (sqlerrd[0]). Ne vous y fiez pas. Le serveur de base de données ne + peut jamais retourner le nombre de lignes actuel qui sera retourné + par une requête SELECT car il n'a pas commencé à les récupérer + àce stade (juste après "PREPARE", lorsque l'optimisateur a déterminé + le plan de requête). + </para> + <para> + <function>ifx_affected_rows</function> est très pratique après + <function>ifx_prepare</function> pour limiter la taille des résultats. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result_id</parameter></term> + <listitem> + <para> + Un identifiant de résultat valide retourné par la fonction + <function>ifx_query</function> ou la fonction + <function>ifx_prepare</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nombre de lignes, sous la forme d'un &integer;. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> <example> <title>Nombre de lignes affectées</title> <programlisting role="php"> <![CDATA[ <?php -$rid = ifx_prepare ("select * from emp +$rid = ifx_prepare("select * from emp where name like " . $name, $connid); if (! $rid) { - //... erreur ... + /* ... erreur ... */ } -$rowcount = ifx_affected_rows ($rid); +$rowcount = ifx_affected_rows($rid); if ($rowcount > 1000) { printf ("Trop de lignes trouvées (%d)\n ", $rowcount); - die ("Ressayez avec une autre requête. \n"); + die ("Rééssayez avec une autre requête. \n"); } ?> ]]> </programlisting> </example> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_num_rows</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  - + +  - <refentry id="function.ifx-blobinfile-mode"> - <refnamediv> - <refname>ifx_blobinfile_mode</refname> - <refpurpose> - Choisit le mode par défaut des objets BLOB pour toutes les - requêtes SELECT - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>ifx_blobinfile_mode</methodname> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - <function>ifx_blobinfile_mode</function> modifie le mode par défaut - des objets BLOB pour toutes les requêtes SELECT. - Mode "0" chargera les BLOB de type Byte en mémoire ; - Mode "1" sauvera les BLOB de type Byte dans un fichier. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> +<refentry id="function.ifx-blobinfile-mode"> + <refnamediv> + <refname>ifx_blobinfile_mode</refname> + <refpurpose>Choisit le mode par défaut des objets BLOB pour toutes les + requêtes SELECT</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>ifx_blobinfile_mode</methodname> + <methodparam><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + Choisit le mode par défaut des objets BLOB pour toutes les requêtes SELECT. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + Mode "0" chargera les BLOB de type Byte en mémoire ; + Mode "1" sauvera les BLOB de type Byte dans un fichier. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ifx/functions/ifx-byteasvarchar.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/ifx/functions/ifx-byteasvarchar.xml diff -u phpdoc-fr/reference/ifx/functions/ifx-byteasvarchar.xml:1.9 phpdoc-fr/reference/ifx/functions/ifx-byteasvarchar.xml:1.10 --- phpdoc-fr/reference/ifx/functions/ifx-byteasvarchar.xml:1.9 Sat May 6 18:05:10 2006 +++ phpdoc-fr/reference/ifx/functions/ifx-byteasvarchar.xml Mon Feb 5 10:59:53 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  <refentry id="function.ifx-byteasvarchar"> @@ -8,21 +8,51 @@ <refname>ifx_byteasvarchar</refname> <refpurpose>Choisit le mode par défaut des objets BYTE</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>ifx_byteasvarchar</methodname> <methodparam><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_byteasvarchar</function> modifie le mode par défaut - des objets BYTE. Le mode "0" retournera l'identifiant de BLOB, et - le mode "1" retournera le contenu du TEXT sous la forme d'un VARCHAR. + Choisit le mode par défaut des objets BYTE pour toutes les requêtes de sélection. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + Le mode "0" retournera l'identifiant de BLOB, et + le mode "1" retournera le contenu du TEXT sous la forme d'un VARCHAR. + </para> + </listitem> + </varlistentry> + </variablelist> </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_textasvarchar</function></member> + </simplelist> + </para> + </refsect1> + </refentry>  - + +  - <refentry id="function.ifx-close"> - <refnamediv> - <refname>ifx_close</refname> - <refpurpose>Ferme une connexion à un serveur Informix</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>ifx_close</methodname> - <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> - </methodsynopsis> - <para> - &return.success; - </para> - <para> - <function>ifx_close</function> ferme le lien au serveur de données - Informix associé à l'identifant de connexion - <parameter>link_identifier</parameter>. - Si l'identifiant du lien n'est pas spécifié, la - dernière connexion est utilisée. - </para> - <para> - Notez qu'il n'est généralement pas besoin d'appeler - cette fonction, car les connexions non persistantes seront - automatiquement fermées. - </para> - <para> - <function>ifx_close</function> ne peut pas fermer une connexion ouverte avec - <function>ifx_pconnect</function>. - </para> - <para> - <example> - <title>Fermer une connexion Informix</title> - <programlisting role="php"> +<refentry id="function.ifx-close"> + <refnamediv> + <refname>ifx_close</refname> + <refpurpose>Ferme une connexion à un serveur Informix</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>ifx_close</methodname> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> + </methodsynopsis> + <para> + <function>ifx_close</function> ferme le lien au serveur de données + Informix associé à l'identifant de connexion + <parameter>link_identifier</parameter>. + </para> + <para> + Notez qu'il n'est généralement pas besoin d'appeler + cette fonction, car les connexions non persistantes seront + automatiquement fermées. + </para> + <para> + <function>ifx_close</function> ne peut pas fermer une connexion ouverte avec + <function>ifx_pconnect</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>link_identifier</parameter></term> + <listitem> + <para> + L'identifiant du lien. S'il n'est pas spécifié, le dernier lien ouvert + est utilisé. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Fermer une connexion Informix</title> + <programlisting role="php"> <![CDATA[ <?php -$conn_id = ifx_connect ("mydb@ol_srv", "coucou", "cestmoi"); -//... quelques requêtes diverses et variées ... +$conn_id = ifx_connect ("mydb@ol_srv", "itsme", "mypassword"); +/* ... quelques requêtes diverses et variées ... */ ifx_close($conn_id); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>ifx_connect</function> et - <function>ifx_pconnect</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_connect</function></member> + <member><function>ifx_pconnect</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ifx/functions/ifx-connect.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/ifx/functions/ifx-connect.xml diff -u phpdoc-fr/reference/ifx/functions/ifx-connect.xml:1.10 phpdoc-fr/reference/ifx/functions/ifx-connect.xml:1.11 --- phpdoc-fr/reference/ifx/functions/ifx-connect.xml:1.10 Sat May 6 18:05:10 2006 +++ phpdoc-fr/reference/ifx/functions/ifx-connect.xml Mon Feb 5 10:59:53 2007 @@ -1,65 +1,114 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.ifx-connect"> - <refnamediv> - <refname>ifx_connect</refname> - <refpurpose>Ouvre une connexion à un serveur Informix</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>ifx_connect</methodname> - <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>userid</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> - </methodsynopsis> - <para> - <function>ifx_connect</function> retourne un identifiant de connexion, en - cas de succès, et &false; sinon. - </para> - <para> - <function>ifx_connect</function> établit une connexion à un - serveur Informix. Tous les arguments sont optionnels, et, s'ils viennent - à manquer, les valeurs par défaut seront prises dans le - fichier <link linkend="configuration.file">de configuration </link>. - (ifx.default_host pour l'hôte par défaut) (Les bibliothèques - Informix utiliseront la variable d'environnement <envar>$INFORMIXSERVER</envar> - si ifx.default_host n'est pas définie). ifx.default_user pour - l'utilisateur, et ifx.default_password comme mot de passe (si aucun n'a - été défini). - </para> - <para> - Si un deuxième appel à <function>ifx_connect</function> est - fait avec les mêmes arguments, l'identifiant de connexion - déjà ouvert sera retourné. - </para> - <para> - Le lien avec le serveur sera fermé dès que le script se - termine, ce qui fait qu'il n'est pas nécessaire de terminer - les connexions avec <function>ifx_close</function>. - </para> - <para> - <example> - <title>Connection à un serveur Informix</title> - <programlisting role="php"> +<refentry id="function.ifx-connect"> + <refnamediv> + <refname>ifx_connect</refname> + <refpurpose>Ouvre une connexion à un serveur Informix</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>ifx_connect</methodname> + <methodparam choice="opt"><type>string</type><parameter>database</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>userid</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam> + </methodsynopsis> + <para> + <function>ifx_connect</function> établit une connexion à un + serveur Informix. + </para> + <para> + Si un deuxième appel à <function>ifx_connect</function> est + fait avec les mêmes arguments, l'identifiant de connexion + déjà ouvert sera retourné. + </para> + <para> + Le lien avec le serveur sera fermé dès que le script se + termine, ce qui fait qu'il n'est pas nécessaire de terminer + les connexions avec <function>ifx_close</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + Tous les arguments sont optionnels, et, s'ils viennent + à manquer, les valeurs par défaut seront prises dans le + &php.ini; (ifx.default_host pour l'hôte par défaut) (Les bibliothèques + Informix utiliseront la variable d'environnement <envar>$INFORMIXSERVER</envar> + si ifx.default_host n'est pas définie). ifx.default_user pour + l'utilisateur, et ifx.default_password comme mot de passe (si aucun n'a + été défini). + </para> + <para> + <variablelist> + <varlistentry> + <term><parameter>database</parameter></term> + <listitem> + <para> + Le nom de la base de données, sous la forme d'une &string;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>userid</parameter></term> + <listitem> + <para> + Le nom d'utilisateur, sous la forme d'une &string;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Le mot de passe, sous la forme d'une &string;. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un identifiant de connexion en cas de succès, ou + &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Connection à un serveur Informix</title> + <programlisting role="php"> <![CDATA[ <?php $conn_id = ifx_connect ("mydb@ol_srv1", "imyself", "mypassword"); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>ifx_pconnect</function> et - <function>ifx_close</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_pconnect</function></member> + <member><function>ifx_close</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ifx/functions/ifx-copy-blob.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/ifx/functions/ifx-copy-blob.xml diff -u phpdoc-fr/reference/ifx/functions/ifx-copy-blob.xml:1.7 phpdoc-fr/reference/ifx/functions/ifx-copy-blob.xml:1.8 --- phpdoc-fr/reference/ifx/functions/ifx-copy-blob.xml:1.7 Tue Nov 16 21:44:43 2004 +++ phpdoc-fr/reference/ifx/functions/ifx-copy-blob.xml Mon Feb 5 10:59:53 2007 @@ -1,27 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.ifx-copy-blob"> - <refnamediv> - <refname>ifx_copy_blob</refname> - <refpurpose>Duplique un objet BLOB</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>ifx_copy_blob</methodname> - <methodparam><type>int</type><parameter>bid</parameter></methodparam> - </methodsynopsis> - <para> - Duplique un objet BLOB dont l'identifiant est <parameter>bid</parameter>. - </para> - <para> - <function>ifx_copy_blob</function> retourne &false; en cas d'erreur ou - l'identifiant du nouvel objet en cas de succès. - </para> - </refsect1> - </refentry> + +<refentry id="function.ifx-copy-blob"> + <refnamediv> + <refname>ifx_copy_blob</refname> + <refpurpose>Duplique un BLOB</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>ifx_copy_blob</methodname> + <methodparam><type>int</type><parameter>bid</parameter></methodparam> + </methodsynopsis> + <para> + Duplique le BLOB fourni. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>bid</parameter></term> + <listitem> + <para> + L'identifiant d'un BLOB. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne l'identifiant vers le nouveau BLOB, ou &false; + si une erreur survient. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_create_blob</function></member> + <member><function>ifx_free_blob</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ifx/functions/ifx-create-blob.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/ifx/functions/ifx-create-blob.xml diff -u phpdoc-fr/reference/ifx/functions/ifx-create-blob.xml:1.9 phpdoc-fr/reference/ifx/functions/ifx-create-blob.xml:1.10 --- phpdoc-fr/reference/ifx/functions/ifx-create-blob.xml:1.9 Sat May 6 18:05:10 2006 +++ phpdoc-fr/reference/ifx/functions/ifx-create-blob.xml Mon Feb 5 10:59:53 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  <refentry id="function.ifx-create-blob"> @@ -8,7 +8,8 @@ <refname>ifx_create_blob</refname> <refpurpose>Crée un objet BLOB</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>ifx_create_blob</methodname> @@ -17,24 +18,62 @@ <methodparam><type>string</type><parameter>param</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_create_blob</function> crée un objet BLOB. - </para> - <para> - type: 1 = TEXT, 0 = BYTE + Crée un objet BLOB. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - mode: 0 = L'objet BLOB place le contenu en mémoire ; - 1 = L'objet BLOB place le contenu dans un fichier. + <variablelist> + <varlistentry> + <term><parameter>type</parameter></term> + <listitem> + <para> + 1 = TEXT, 0 = BYTE + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + 0 = L'objet BLOB place le contenu en mémoire, + 1 = L'objet BLOB place le contenu dans un fichier. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>param</parameter></term> + <listitem> + <para> + Si mode = 0: pointeur du contenu, + si mode = 1: pointeur vers un fichier. + </para> + </listitem> + </varlistentry> + </variablelist> </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - param: Si mode = 0: pointeur du contenu, - si mode = 1: pointeur vers un fichier. + Retourne l'identifiant vers le nouveau BLOB, ou &false; + si une erreur survient. </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - <function>ifx_create_blob</function> retourne &false; - en cas d'erreur, et sinon, un identifiant de BLOB. + <simplelist> + <member><function>ifx_copy_blob</function></member> + <member><function>ifx_free_blob</function></member> + </simplelist> </para> </refsect1> + </refentry>  - + +  <refentry id="function.ifx-create-char"> @@ -8,20 +8,51 @@ <refname>ifx_create_char</refname> <refpurpose>Crée un objet char</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>ifx_create_char</methodname> <methodparam><type>string</type><parameter>param</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_create_char</function> crée un objet char. - <parameter>param</parameter> sera le contenu de l'objet. + Crée un objet char. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>param</parameter></term> + <listitem> + <para> + Le contenu du char. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne l'identifiant vers le nouvel objet char, ou &false; + si une erreur survient. </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Retourne &false; en cas d'erreur, sinon, l'identifiant du nouvel objet char. + <simplelist> + <member><function>ifx_free_char</function></member> + </simplelist> </para> </refsect1> + </refentry>  - + +  <refentry id="function.ifx-do"> @@ -8,34 +8,79 @@ <refname>ifx_do</refname> <refpurpose>Exécute une requête SQL préparée</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>ifx_do</methodname> <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_do</function> exécute une requête qui - a déjà été - préparée, ou crée un pointeur pour cela. - </para> - <para> - &return.success;. + Exécute une requête qui a déjà été préparée, ou crée un pointeur pour cela. </para> <para> - <function>ifx_do</function> ne libère pas + <function>ifx_do</function> ne libère pas <parameter>result_id</parameter> en cas d'erreur. </para> <para> - De plus, <function>ifx_do</function> fixe la valeur de + De plus, <function>ifx_do</function> fixe la valeur de <parameter>result_id</parameter> pour accès ultérieur par <function>ifx_affected_rows</function>. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result_id</parameter></term> + <listitem> + <para> + <parameter>result_id</parameter> est un identifiant de résultat valide + retourné par la fonction <function>ifx_query</function> ou la fonction + <function>ifx_prepare</function> (uniquement les requêtes de type SELECT !). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>ifx_prepare</function>. + <example> + <title>Exemple avec <function>ifx_do</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$conn = fx_connect( "db", "user", "password" ); +$result = ifx_prepare("SELECT customer_num, company FROM customer", $conn); +ifx_do($result); +?> +]]> + </programlisting> + </example> </para> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_prepare</function></member> + </simplelist> + </para> + </refsect1> + </refentry>  - + +  <refentry id="function.ifx-errormsg"> <refnamediv> <refname>ifx_errormsg</refname> - <refpurpose> - Retourne le message d'erreur de la dernière requête Informix - </refpurpose> + <refpurpose>Retourne le message d'erreur de la dernière requête Informix</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>ifx_errormsg</methodname> <methodparam choice="opt"><type>int</type><parameter>errorcode</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_errormsg</function> retourne le plus récent - message d'erreur ou, lorsque l'option <parameter>errorcode</parameter> est - présente, le message d'erreur associé à - <parameter>errorcode</parameter>. + Retourne le message d'erreur associé à la dernière erreur Informix. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>errorcode</parameter></term> + <listitem> + <para> + Si spécifié, la fonction retournera le message correspondant au code + erreur spécifié. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le message d'erreur, sous la forme d'une &string;. </para> - <example> - <title>Exemple avec <function>ifx_errormsg</function></title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>ifx_errormsg</function></title> + <programlisting role="php"> <![CDATA[ -<?php -printf("%s\n ", ifx_errormsg(-201)); -?> +printf("%s\n ", ifx_errormsg(-201)); ]]> </programlisting> </example> - <para> - Voir aussi - <function>ifx_error</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_error</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  - + +  <refentry id="function.ifx-error"> <refnamediv> <refname>ifx_error</refname> - <refpurpose> - Retourne le code d'erreur de la dernière requête Informix - </refpurpose> + <refpurpose>Retourne le code d'erreur de la dernière requête Informix</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>ifx_error</methodname> - <methodparam choice="opt"><type>resource</type><parameter>connection_id</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_error</function> retourne le code d'erreur de la dernière - requête Informix. Les codes d'erreur Informix (<constant>SQLSTATE</constant> - et <constant>SQLCODE</constant>) sont formatés comme suit : + Retourne un seul caractère décrivant les résultats généraux d'une requête + ainsi que SQLSTATE et SQLCODE associés avec la requête SQL la plus récente. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>link_identifier</parameter></term> + <listitem> + <para> + L'identifiant du lien. + </para> + </listitem> + </varlistentry> + </variablelist> </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - x [SQLSTATE = aa bbb SQLCODE=cccc] + Les codes erreurs Informix (SQLSTATE & SQLCODE) sont formattés ainsi : + <literal>x [SQLSTATE = aa bbb SQLCODE=cccc]</literal>. </para> <para> - avec x = space : aucune erreur + où x = space : aucune erreur </para> <para> E : erreur </para> <para> - N : il n'y a plus d'informations + N : il n'y a plus de donnée </para> <para> W : alerte @@ -40,29 +59,24 @@ ? : indéfinie </para> <para> - Si le caractère vaut autre chose qu'un espace, SQLSTATE et SQLCODE + Si le caractère "x" vaut autre chose qu'un espace, SQLSTATE et SQLCODE décrivent l'erreur avec plus de détails. </para> <para> Reportez-vous au manuel Informix pour trouver la description de - SQLSTATE et SQLCODE - </para> - <para> - <function>ifx_error</function> retourne une chaîne avec un caractère, - décrivant le résultat général de la commande, - et aussi SQLSTATE et SQLCODE associés à la plus récente - requête SQL exécutée. Le format de la chaîne est - "(char) [SQLSTATE=(deux chiffres) (trois chiffres) SQLCODE=(un chiffre)]". - Le premier caractère peut être '<literal> </literal>' - (espace) (succès), '<literal>W</literal>' (Alerte), - '<literal>E</literal>' (une erreur est survenue durant le traitement ) - ou '<literal>N</literal>' (aucune donnée de retour). + SQLSTATE et SQLCODE. </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>ifx_errormsg</function>. + <simplelist> + <member><function>ifx_errormsg</function></member> + </simplelist> </para> </refsect1> + </refentry>  - + +  - <refentry id="function.ifx-fetch-row"> - <refnamediv> - <refname>ifx_fetch_row</refname> - <refpurpose> - Retourne une ligne sous la forme d'un tableau énuméré - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>ifx_fetch_row</methodname> - <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>position</parameter></methodparam> - </methodsynopsis> - <para> - <function>ifx_fetch_row</function> retourne un tableau associatif qui - contient la ligne retournée ou &false; s'il ne reste plus de - lignes à lire, ou s'il a eu une erreur. - </para> - <para> - Les colonnes de types BLOB sont retournées sous la forme d'un - identifiant à utiliser avec <function>ifx_get_blob</function> - à moins que vous n'ayez utilisé la fonction - <function>ifx_textasvarchar</function> ou - <function>ifx_byteasvarchar</function> et, dans ce cas, les BLOBs - seront retournés sous forme de chaîne. - <function>ifx_fetch_row</function> retourne &false; - en cas d'erreur. - </para> - <para> - <parameter>result_id</parameter> est un identifiant valide de résultat, - retourné par <function>ifx_query</function> ou - <function>ifx_prepare</function> (Requêtes SELECT seulement !). - </para> - <para> - <parameter>position</parameter> est un paramètre - optionnel, pour une opération de lecture d'informations sur un pointeur - de type "scroll": "NEXT", "PREVIOUS", "CURRENT", "FIRST", "LAST" ou encore un - nombre. Si vous spécifiez un nombre, la ligne d'index absolu sera - retournée. Ce paramètre est optionnel, et ne fonctionne qu'avec - les pointeurs de type "scroll". - </para> - <para> - <function>ifx_fetch_row</function> retourne une ligne de données d'un - résultat associé à l'identifiant de résultat - <parameter>result_id</parameter>. La ligne est retournée sous la - forme d'un tableau associatif. Chaque résultat est stocké dans un tableau associatif, - dont l'index numérique commence à 0 et ayant comme clé, le nom du champ. - </para> - <para> - Les appels ultérieurs à <function>ifx_fetch_row</function> - retourneront la ligne suivante, ou &false; s'il n'y a plus de ligne. - </para> - <para> - <example> - <title>Exemple avec <function>ifx_fetch_row</function></title> - <programlisting role="php"> +<refentry id="function.ifx-fetch-row"> + <refnamediv> + <refname>ifx_fetch_row</refname> + <refpurpose>Retourne une ligne sous la forme d'un tableau énuméré</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>ifx_fetch_row</methodname> + <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>position</parameter></methodparam> + </methodsynopsis> + <para> + Retourne une ligne de données d'un résultat associé à l'identifiant de résultat + <parameter>result_id</parameter>. + </para> + <para> + Les appels ultérieurs à <function>ifx_fetch_row</function> + retourneront la ligne suivante, ou &false; s'il n'y a plus de ligne. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result_id</parameter></term> + <listitem> + <para> + <parameter>result_id</parameter> est un identifiant valide de résultat, + retourné par <function>ifx_query</function> ou + <function>ifx_prepare</function> (Requêtes SELECT seulement !). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>position</parameter></term> + <listitem> + <para> + <parameter>position</parameter> est un paramètre + optionnel, pour une opération de lecture d'informations sur un pointeur + de type "scroll": <literal>NEXT</literal>, <literal>PREVIOUS</literal>, + <literal>CURRENT</literal>, <literal>FIRST</literal>, + <literal>LAST</literal> ou encore un nombre. Si vous spécifiez un nombre, + la ligne d'index absolu sera retournée. Ce paramètre est optionnel, et ne + fonctionne qu'avec les pointeurs de type "scroll". + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + retourne un tableau associatif qui contient la ligne retournée ou + &false; s'il ne reste plus de lignes à lire, ou s'il a eu une erreur. + </para> + <para> + Les colonnes de types BLOB sont retournées sous la forme d'un + identifiant à utiliser avec <function>ifx_get_blob</function> + à moins que vous n'ayez utilisé la fonction + <function>ifx_textasvarchar</function> ou + <function>ifx_byteasvarchar</function> et, dans ce cas, les BLOBs + seront retournés sous forme de chaîne. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>ifx_fetch_row</function></title> + <programlisting role="php"> <![CDATA[ <?php $rid = ifx_prepare ("select * from emp where name like " . $name, $connid, IFX_SCROLL); if (! $rid) { -// ... erreur ... + /* ... erreur ... */ } $rowcount = ifx_affected_rows($rid); if ($rowcount > 1000) { printf ("Trop de lignes dans le résultat. (%d)\n ", $rowcount); - die ("Recommencez votre requête. \n"); + die ("Restreignez votre requête. \n"); } if (! ifx_do ($rid)) { -// ... erreur ... + /* ... erreur ... */ } $row = ifx_fetch_row ($rid, "NEXT"); while (is_array($row)) { @@ -87,11 +107,12 @@ ifx_free_result ($rid); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry>  - + +  - <refentry id="function.ifx-fieldproperties"> - <refnamediv> - <refname>ifx_fieldproperties</refname> - <refpurpose>Liste les propriétés des champs SQL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>ifx_fieldproperties</methodname> - <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> - </methodsynopsis> - <para> - <function>ifx_fieldproperties</function> retourne un tableau associatif - avec les noms des champs comme clés, et les données de - propriétés des champs comme valeurs. - <function>ifx_fieldproperties</function> retourne &false; en - cas d'erreur. - </para> - <para> - <function>ifx_fieldproperties</function> retourne les propriétés - Informix SQL pour tous les champs - d'une requête, sous la forme d'un tableau associatif. Les - propriétés sont présentées sous la forme - : "SQLTYPE;longueur ;précision;échelle;ISNULLABLE" avec - SQLTYPE qui représente le type de données Informix tel - que "SQLVCHAR" et ISNULLABLE = "Y" ou "N" (le champ peut contenir NULL - ou pas : Oui ou Non). - </para> - <para> - <example> - <title>Exemple avec <function>ifx_fieldproperties</function></title> - <programlisting role="php"> +<refentry id="function.ifx-fieldproperties"> + <refnamediv> + <refname>ifx_fieldproperties</refname> + <refpurpose>Liste les propriétés des champs SQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>ifx_fieldproperties</methodname> + <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> + </methodsynopsis> + <para> + Retourne les propriétés Informix SQL pour tous les champs + d'une requête, sous la forme d'un tableau associatif. Les + propriétés sont présentées sous la forme + : "SQLTYPE;longueur ;précision;échelle;ISNULLABLE" avec + SQLTYPE qui représente le type de données Informix tel + que "SQLVCHAR" et ISNULLABLE = "Y" ou "N" (le champ peut contenir NULL + ou pas : Oui ou Non). + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result_id</parameter></term> + <listitem> + <para> + <parameter>result_id</parameter> est un identifiant de résultats valide + retourné par la fonction <function>ifx_query</function> ou la fonction + <function>ifx_prepare</function> (Requête de type SELECT uniquement !). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif avec les noms des champs comme clés, et les données de + propriétés des champs comme valeurs. <function>ifx_fieldproperties</function> + retourne &false; en cas d'erreur. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>ifx_fieldproperties</function></title> + <programlisting role="php"> <![CDATA[ +<?php $properties = ifx_fieldproperties($resultid); if (!isset($properties)) { - /* ... erreur ... */ + /* ... erreur ... */ } foreach ($properties as $fname => $val) { - echo "$fname:\t property = $val\n"; + echo "$fname :\t property = $val\n"; } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_fieldtypes</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ifx/functions/ifx-fieldtypes.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/ifx/functions/ifx-fieldtypes.xml diff -u phpdoc-fr/reference/ifx/functions/ifx-fieldtypes.xml:1.10 phpdoc-fr/reference/ifx/functions/ifx-fieldtypes.xml:1.11 --- phpdoc-fr/reference/ifx/functions/ifx-fieldtypes.xml:1.10 Sat May 6 18:05:10 2006 +++ phpdoc-fr/reference/ifx/functions/ifx-fieldtypes.xml Mon Feb 5 10:59:53 2007 @@ -1,44 +1,83 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  - <refentry id="function.ifx-fieldtypes"> - <refnamediv> - <refname>ifx_fieldtypes</refname> - <refpurpose>Liste les champs Informix SQL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>ifx_fieldtypes</methodname> - <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> - </methodsynopsis> - <para> - <function>ifx_fieldtypes</function> retourne un tableau associatif avec - les noms des champs comme clés, et les types SQL comme valeurs. En - cas d'erreur, retourne &false;. - </para> - <para> - <example> - <title>Nom de champs et type SQL.</title> - <programlisting role="php"> +<refentry id="function.ifx-fieldtypes"> + <refnamediv> + <refname>ifx_fieldtypes</refname> + <refpurpose>Liste les champs Informix SQL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>ifx_fieldtypes</methodname> + <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> + </methodsynopsis> + <para> + Retourne un tableau associatif avec les noms des champs comme + clés, et les types SQL comme valeurs. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result_id</parameter></term> + <listitem> + <para> + <parameter>result_id</parameter> est un identifiant de résultats valide, + retourné par la fonction <function>ifx_query</function> ou la fonction + <function>ifx_prepare</function> (requêtes de type SELECT uniquement !). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif avec les noms des champs comme + clés, et les types SQL comme valeurs. En cas d'erreur, retourne &false;. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Nom de champs et type SQL</title> + <programlisting role="php"> <![CDATA[ <?php $types = ifx_fieldtypes($resultid); -if (!isset($types)) { - /* ... erreur ... */ -} -foreach ($types as $fname => $val) { - echo "$fname:\t type = $val\n"; +if (is_array($types)) { + foreach ($types as $fname => $val) { + echo "$fname :\t type = $val\n"; + } } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_fieldproperties</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  - + +  <refentry id="function.ifx-free-blob"> @@ -8,20 +8,50 @@ <refname>ifx_free_blob</refname> <refpurpose>Supprime un objet BLOB</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>ifx_free_blob</methodname> <methodparam><type>int</type><parameter>bid</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_free_blob</function> supprime l'objet BLOB - <parameter>bid</parameter>. + Supprime l'objet BLOB dont l'identifiant est fourni. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>bid</parameter></term> + <listitem> + <para> + L'identifiant de l'objet BLOB. + </para> + </listitem> + </varlistentry> + </variablelist> </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_create_blob</function></member> + </simplelist> + </para> + </refsect1> + </refentry>  - + +  <refentry id="function.ifx-free-char"> @@ -8,20 +8,50 @@ <refname>ifx_free_char</refname> <refpurpose>Supprime un objet char</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>ifx_free_char</methodname> <methodparam><type>int</type><parameter>bid</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_free_char</function> supprime l'objet char - <parameter>bid</parameter>. + Supprime l'objet char dont l'identifiant est fourni. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>bid</parameter></term> + <listitem> + <para> + L'identifiant de l'objet char. + </para> + </listitem> + </varlistentry> + </variablelist> </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> &return.success; </para> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_create_char</function></member> + </simplelist> + </para> + </refsect1> + </refentry>  - + +  - <refentry id="function.ifx-free-result"> - <refnamediv> - <refname>ifx_free_result</refname> - <refpurpose>Libère les ressources prises par un résultat</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>ifx_free_result</methodname> - <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> - </methodsynopsis> - <para> - <function>ifx_free_result</function> libère les ressources prises - par le résultat <parameter>result_id</parameter>. - </para> - <para> - &return.success; - </para> - </refsect1> - </refentry> +<refentry id="function.ifx-free-result"> + <refnamediv> + <refname>ifx_free_result</refname> + <refpurpose>Libère les ressources prises par un résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>ifx_free_result</methodname> + <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> + </methodsynopsis> + <para> + Libère les ressources prises par le résultat associé avec + <parameter>result_id</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result_id</parameter></term> + <listitem> + <para> + <parameter>result_id</parameter> est un identifiant de résultats valide, + retourné par la fonction <function>ifx_query</function> ou la fonction + <function>ifx_prepare</function> (requêtes de type SELECT uniquement !). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_do</function></member> + </simplelist> + </para> + </refsect1> + +</refentry>  +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ifx/functions/ifx-get-blob.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/ifx/functions/ifx-get-blob.xml diff -u phpdoc-fr/reference/ifx/functions/ifx-get-blob.xml:1.9 phpdoc-fr/reference/ifx/functions/ifx-get-blob.xml:1.10 --- phpdoc-fr/reference/ifx/functions/ifx-get-blob.xml:1.9 Sat May 6 18:05:10 2006 +++ phpdoc-fr/reference/ifx/functions/ifx-get-blob.xml Mon Feb 5 10:59:53 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + +  <refentry id="function.ifx-get-blob"> @@ -8,17 +8,51 @@ <refname>ifx_get_blob</refname> <refpurpose>Retourne le contenu d'un objet BLOB</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>ifx_get_blob</methodname> <methodparam><type>int</type><parameter>bid</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_get_blob</function> retourne le contenu de l'objet BLOB - associé à <parameter>bid</parameter>. + Retourne le contenu d'un objet BLOB. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>bid</parameter></term> + <listitem> + <para> + L'identifiant de l'objet BLOB. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Le contenu du BLOB, sous la forme d'une &string;, ou + &false; si une erreur survient. </para> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_get_char</function></member> + </simplelist> + </para> + </refsect1> + </refentry>  - + +  <refentry id="function.ifx-get-char"> @@ -8,17 +8,51 @@ <refname>ifx_get_char</refname> <refpurpose>Retourne le contenu d'un objet char</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>ifx_get_char</methodname> <methodparam><type>int</type><parameter>bid</parameter></methodparam> </methodsynopsis> <para> - <function>ifx_get_char</function> retourne le contenu de l'objet - associé à l'identifiant <parameter>bid</parameter>. + Retourne le contenu d'un objet char. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>bid</parameter></term> + <listitem> + <para> + L'identifiant de l'objet char. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le contenu sous la forme d'une &string;, ou + &false; si une erreur survient. </para> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>ifx_get_blob</function></member> + </simplelist> + </para> + </refsect1> + </refentry>  - + +  - <refentry id="function.ifx-getsqlca"> - <refnamediv> - <refname>ifx_getsqlca</refname> - <refpurpose> - Retourne le contenu de la variable sqlca.sqlerrd[0..5] après une requête - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>ifx_getsqlca</methodname> - <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> - </methodsynopsis> - <para> - <function>ifx_getsqlca</function> retourne une pseudo-ligne (tableau - associatif) avec sqlca.sqlerrd[0] à sqlca.sqlerrd[5] après - la requête associée <parameter>result_id</parameter>. - </para> - <para> - <parameter>result_id</parameter> est un identifiant valide de résultat - retourné par <function>ifx_query</function> ou - <function>ifx_prepare</function>. - </para> - <para> - Pour les requêtes INSERT, UPDATE et DELETE, les valeurs - retournées sont celles fixées par le serveur après - avoir exécuté la requête. Cela donne accès au - nombre de lignes affectées, ainsi qu'au numéro de série - d'insertion. Pour les requêtes de type SELECT, les valeurs - retournées sont celles qui ont été - préparées. Utiliser cette fonction économise - l'exécution d'une requête "select dbinfo('sqlca.sqlerrdx')", - étant donné qu'elle retourne les valeurs qui ont été - sauvées par le pilote ifx au moment approprié. - </para> - <para> - <example> - <title>Lire les valeurs de sqlca.sqlerrd[x] </title> - <programlisting role="php"> +<refentry id="function.ifx-getsqlca"> + <refnamediv> + <refname>ifx_getsqlca</refname> + <refpurpose>Retourne le contenu de la variable sqlca.sqlerrd[0..5] après une requête</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>ifx_getsqlca</methodname> + <methodparam><type>resource</type><parameter>result_id</parameter></methodparam> + </methodsynopsis> + <para> + Retourne une pseudo-ligne (tableau associatif) avec sqlca.sqlerrd[0] + à sqlca.sqlerrd[5] après la requête associée <parameter>result_id</parameter>. + </para> + <para> + Pour les requêtes <literal>INSERT</literal>, <literal>UPDATE</literal> + et <literal>DELETE</literal>, les valeurs retournées sont celles fixées + par le serveur après avoir exécuté la requête. Cela donne accès au + nombre de lignes affectées, ainsi qu'au numéro de série d'insertion. + Pour les requêtes de type <literal>SELECT</literal>, les valeurs + retournées sont celles qui ont été préparées. Utiliser cette fonction + économise l'exécution d'une requête <literal>SELECT + dbinfo('sqlca.sqlerrdx')</literal>, étant donné qu'elle retourne les + valeurs qui ont été sauvées par le pilote ifx au moment approprié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>result_id</parameter></term> + <listitem> + <para> + <parameter>result_id</parameter> est un identifiant de résultats valide, + retourné par la fonction <function>ifx_query</function> ou la fonction + <function>ifx_prepare</function> (requêtes de type SELECT uniquement !). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif, composé des entrées suivantes : + <literal>sqlerrd0</literal>, <literal>sqlerrd1</literal>, + <literal>sqlerrd2</literal>, <literal>sqlerrd3</literal>, + <literal>sqlerrd4</literal> et <literal>sqlerrd5</literal>. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Lire les valeurs de sqlca.sqlerrd[x]</title> + <programlisting role="php"> <![CDATA[ <?php /* On suppose que la première colonne d'une table 'quelconque' est un numéro de série */ -$qid = ifx_query("insert into sometable values(0, '2nd column', 'another column' ", $connid); +$qid = ifx_query("insert into sometable + values (0, '2nd column', 'another column') ", $connid); if (!$qid) { - // ... erreur ... + /* ... erreur ... */ } $sqlca = ifx_getsqlca($qid); $serial_value = $sqlca["sqlerrd1"]; -echo "Le numéro de série de la valeur insérée - est : " . $serial_value . " \n"; +echo "Le numéro de série de la valeur insérée est : $serial_value \n"; ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: