cvs: phpdoc-fr /reference/oci8/functions oci-bind-by-name.xml oci-cancel.xml oci-close.xml oci-collection-append.xml oci-collection-assign.xml
oci-collection-element-assign.xml oci-collection-element-get.xml ocibindbyname.xml ocicancel.xml ocicollappend.xml ocicollassign.xml
ocicollassignelem.xml ocicollgetelem.xml

From: Date: Thu, 01 Apr 2004 14:23:14 +0000
Subject: cvs: phpdoc-fr /reference/oci8/functions oci-bind-by-name.xml oci-cancel.xml oci-close.xml oci-collection-append.xml oci-collection-assign.xml
oci-collection-element-assign.xml oci-collection-element-get.xml ocibindbyname.xml ocicancel.xml ocicollappend.xml ocicollassign.xml
ocicollassignelem.xml ocicollgetelem.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-2118@lists.php.net to get a copy of this message
dams Thu Apr 1 09:23:14 2004 EDT Added files: /phpdoc-fr/reference/oci8/functions oci-bind-by-name.xml oci-cancel.xml oci-close.xml oci-collection-append.xml oci-collection-assign.xml oci-collection-element-assign.xml oci-collection-element-get.xml Removed files: /phpdoc-fr/reference/oci8/functions ocibindbyname.xml ocicancel.xml ocicollappend.xml ocicollassign.xml ocicollassignelem.xml ocicollgetelem.xml Log: moving filenames to naming policy, plus update

http://cvs.php.net/co.php/phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml?r=1.1&p=1 Index: phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml +++ phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: nobody Status: partial --> <refentry id="function.oci-bind-by-name"> <refnamediv> <refname>oci_bind_by_name</refname> <refpurpose> Associe une variable PHP à une variable SQL Oracle </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>oci_bind_by_name</methodname> <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> <methodparam><type>string</type><parameter>ph_name</parameter></methodparam> <methodparam><type>mixed</type><parameter>&amp;variable</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>maxlength</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> <para> <function>oci_bind_by_name</function> relie la variable PHP <parameter>variable</parameter> à l'emplacement Oracle <parameter>ph_name</parameter>. Son utilisation (comme entrée ou comme sortie) sera définie à l'exécution, et l'espace nécessaire sera alloué. Le paramètre de longueur <parameter>length</parameter> fixe la taille maximum pour la liaison. Si vous affectez une longueur de -1, <function>oci_bind_by_name</function> utilisera la longueur de variable comme maximum. </para> <para> Si vous devez lier des types abstraits de données (LOB/ROWID/BFILE), vous devrez l'allouer dans un premier temps, avec <function>ocinewdescriptor</function>. La longueur <parameter>length</parameter> ne sert pas pour ces types et devrait être fixée à -1. La variable <parameter>type</parameter> indique au serveur Oracle, quel type de pointeur va être utilisé. Les valeurs possibles sont : <itemizedlist> <listitem> <para> <constant>OCI_B_FILE</constant> - Pour BFILEs; </para> </listitem> <listitem> <para> <constant>OCI_B_CFILE</constant> - Pour CFILEs; </para> </listitem> <listitem> <para> <constant>OCI_B_CLOB</constant> - Pour CLOBs; </para> </listitem> <listitem> <para> <constant>OCI_B_BLOB</constant> - Pour BLOBs; </para> </listitem> <listitem> <para> <constant>OCI_B_ROWID</constant> - Pour ROWIDs; </para> </listitem> <listitem> <para> <constant>OCI_B_NTY</constant> - Pour les types de données nommés; </para> </listitem> <listitem> <para> <constant>OCI_B_CURSOR</constant> - Pour les curseurs qui ont été créés auparavant, avec <function>oci_new_cursor</function>. </para> </listitem> </itemizedlist> </para> <para> <example> <title>Exemple avec <function>oci_bind_by_name</function></title> <programlisting role="php"> <![CDATA[ <?php /* Exemple ociBindByPos par thies@thieso.net (980221) Insère 3 lignes dans emp, et utilise ROWID pour mettre à jour les lignes, juste après l'insertion. */ $conn = oci_connect("scott", "tiger"); $stmt = oci_parse($conn, " INSERT INTO emp (empno, ename) VALUES (:empno,:ename) RETURNING ROWID INTO :rid "); $data = array( 1111 => "Larry", 2222 => "Bill", 3333 => "Jim" ); $rowid = oci_new_descriptor($conn, OCI_D_ROWID); oci_bind_by_name($stmt, ":empno", $empno, 32); oci_bind_by_name($stmt, ":ename", $ename, 32); oci_bind_by_name($stmt, ":rid", $rowid, -1, OCI_B_ROWID); $update = oci_parse($conn, " UPDATE emp SET sal = :sal WHERE ROWID = :rid "); oci_bind_by_name($update, ":rid", $rowid, -1, OCI_B_ROWID); oci_bind_by_name($update, ":sal", $sal, 32); $sal = 10000; while (list($empno, $ename) = each($data)) { oci_execute($stmt); oci_execute($update); } $rowid->free(); oci_free_statement($update); oci_free_statement($stmt); $stmt = oci_parse($conn, " SELECT * FROM emp WHERE empno IN (1111,2222,3333) "); oci_execute($stmt); while ($row = oci_fetch_assoc($stmt)) { var_dump($row); } oci_free_statement($stmt); /* delete our "junk" from the emp table.... */ $stmt = oci_parse($conn, " DELETE FROM emp WHERE empno IN (1111,2222,3333) "); oci_execute($stmt); oci_free_statement($stmt); oci_close($conn); ?> ]]> </programlisting> </example> </para> <para> N'oubliez pas que cette fonction supprime les caractères d'espace terminaux. Par exemple : </para> <para> <example> <title><function>oci_bind_by_name</function> et les caractères d'espace terminaux</title> <programlisting role="php"> <![CDATA[ <?php $connection = oci_connect('apelsin','kanistra'); $query = "INSERT INTO test_table VALUES(:id, :text)"; $statement = oci_parse($query); oci_bind_by_name($statement, ":id", 1); oci_bind_by_name($statement, ":text", "trailing spaces follow "); oci_execute($statement); /* Ce code va insérer la chaîne 'trailing spaces follow', sans les espaces terminaux. */ ?> ]]> </programlisting> </example> </para> <para> <example> <title><function>oci_bind_by_name</function> et les caractères d'espace terminaux (2)</title> <programlisting role="php"> <![CDATA[ <?php $connection = oci_connect('apelsin','kanistra'); $query = "INSERT INTO test_table VALUES(:id, 'trailing spaces follow ')"; $statement = oci_parse($query); oci_bind_by_name($statement, ":id", 1); oci_execute($statement); /* Ce code va insérer la chaîne 'trailing spaces follow ', avec les espaces terminaux. */ ?> ]]> </programlisting> </example> </para> <warning> <para> C'est une mauvaise idée que d'utiliser les magic quotes et la fonction <function>oci_bind_by_name</function> simultanément, car aucun ajout de guillemets n'est nécessaire sur les variables citées, et tout guillemets magiques sera inscrit dans votre base de données car <function>oci_bind_by_name</function> n'est pas capable de faire la différence entre les guillemets et ceux qui ont été ajoutés dynamiquement. </para> </warning> <para> &return.success; </para> <note> <para> Dans les versions de &php; antérieures ˆ la version 5.0.0, vous devez utiliser la fonction <function>ocibindbyname</function>. Cet ancien nom est toujours utilisable : un alias a été fait vers la fonction <function>oci_bind_by_name</function>, pour assurer la compatibilité ascendante. Toutesfois, il est recommandé de ne plus l'utiliser. </para> </note> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-fr/reference/oci8/functions/oci-cancel.xml?r=1.1&p=1 Index: phpdoc-fr/reference/oci8/functions/oci-cancel.xml +++ phpdoc-fr/reference/oci8/functions/oci-cancel.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: nobody Status: partial --> <refentry id="function.oci-cancel"> <refnamediv> <refname>oci_cancel</refname> <refpurpose>Termine la lecture de ressources Oracle</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>oci_cancel</methodname> <methodparam><type>resource</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <simpara> <function>oci_cancel</function> détruit les ressources liées au dernier résultat <parameter>stmt</parameter>. Si vous ne souhaitez plus lire d'informations dans ce résultat, utilisez cette fonction. </simpara> <para> &return.success; </para> <note> <para> Dans les versions de &php; antérieures ˆ la version 5.0.0, vous devez utiliser la fonction <function>ocicancel</function>. Cet ancien nom est toujours utilisable : un alias a été fait vers la fonction <function>oci-cancel</function>, pour assurer la compatibilité ascendante. Toutesfois, il est recommandé de ne plus l'utiliser. </para> </note> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-fr/reference/oci8/functions/oci-close.xml?r=1.1&p=1 Index: phpdoc-fr/reference/oci8/functions/oci-close.xml +++ phpdoc-fr/reference/oci8/functions/oci-close.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-close"> <refnamediv> <refname>oci_close</refname> <refpurpose>Ferme une connexion Oracle</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>oci_close</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>oci_close</function> ferme la connexion Oracle, représentée par la ressource <parameter>connection</parameter>. </para> <note> <para> Les liens non-persistants sont refermés à la fin du script, et l'appel de cette fonction n'est pas obligatoire. A cause de la méthode de gestion des ressources, <function>oci_close</function> ne fournit aucune véritable fonctionnalité. </para> </note> <para> &return.success; </para> <note> <para> Dans les versions de &php; antÈrieures à la version 5.0.0, vous devez utiliser la fonction <function>ociclose</function>. Cet ancien nom est toujours utilisable : un alias a ÈtÈ fait vers la fonction <function>oci-close</function>, pour assurer la compatibilitÈ ascendante. Toutesfois, il est recommandÈ de ne plus l'utiliser. </para> </note> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-fr/reference/oci8/functions/oci-collection-append.xml?r=1.1&p=1 Index: phpdoc-fr/reference/oci8/functions/oci-collection-append.xml +++ phpdoc-fr/reference/oci8/functions/oci-collection-append.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> <refentry id="function.oci-collection-append"> <refnamediv> <refname>collection->append</refname> <refpurpose>Ajoute un objet à une collection Oracle</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>collection->append</methodname> <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> <para> <function>collection->append</function> ajoute l'objet <parameter>value</parameter> à la collection. Le paramètre <parameter>value</parameter> peut être une chaîne ou un nombre. </para> <para> &return.success; </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-fr/reference/oci8/functions/oci-collection-assign.xml?r=1.1&p=1 Index: phpdoc-fr/reference/oci8/functions/oci-collection-assign.xml +++ phpdoc-fr/reference/oci8/functions/oci-collection-assign.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: nobody Status: partial --> <refentry id="function.oci-collection-assign"> <refnamediv> <refname>collection->assign</refname> <refpurpose> Assigne une valeur ˆ une collection depuis une autre collection Oracle </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>collection->assign</methodname> <methodparam><type>object</type><parameter>from</parameter></methodparam> </methodsynopsis> <para> <function>collection->assign</function> assigne une valeur ˆ une collection, ˆ partir d'une autre collection existante. Les deux collections doivent avoir ŽtŽ crŽŽes avec ˆ <function>oci_new_collection</function> avant d'utiliser cette fonction. </para> <para> &return.success; </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-fr/reference/oci8/functions/oci-collection-element-assign.xml?r=1.1&p=1 Index: phpdoc-fr/reference/oci8/functions/oci-collection-element-assign.xml +++ phpdoc-fr/reference/oci8/functions/oci-collection-element-assign.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-collection-element-assign"> <refnamediv> <refname>collection->assignElem</refname> <refpurpose>Assigne une value à un élément d'une collection Oracle</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>collection->assignElem</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> <para> <function>collection->assignElem</function> assigne la valeur <parameter>value</parameter> à l'élément d'index <parameter>index</parameter>. Le paramètre <parameter>value</parameter> peut être une chaîne de caractères, ou bien un nombre. </para> <para> &return.success; </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-fr/reference/oci8/functions/oci-collection-element-get.xml?r=1.1&p=1 Index: phpdoc-fr/reference/oci8/functions/oci-collection-element-get.xml +++ phpdoc-fr/reference/oci8/functions/oci-collection-element-get.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.oci-collection-element-get"> <refnamediv> <refname>collection->getElem</refname> <refpurpose>Retourne la valeur d'un élément d'une collection Oracle</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>collection->getElem</methodname> <methodparam><type>int</type><parameter>index</parameter></methodparam> </methodsynopsis> <para> <function>collection->getElem</function> retourne la valeur de l'élément d'index <parameter>index</parameter>. Les index sont numérotés à partir de 1. </para> <para> <function>collection->getElem</function> retournera &false; si cet élément n'existe pas; &null;, si l'élément est &null;; chaîne si la colonne est de type chaîne, et nombre si c'est un numérique. field. </para> <para> <function>collection->getElem</function> retourne &false; en cas d'erreur. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.fr (#2118) next »