cvs: phpdoc-fr /reference/pdo/functions PDOStatement-bindColumn.xml PDOStatement-bindParam.xml PDOStatement-closeCursor.xml
PDOStatement-columnCount.xml PDOStatement-errorCode.xml PDOStatement-errorInfo.xml PDOStatement-execute.xml PDOStatement-fetch.xml
PDOStatement-fetchAll.xml PDOStatement-fetchColumn.xml PDOStatement-getAttribute.xml PDOStatement-getColumnMeta.xml PDOStatement-nextRowset.xml
PDOStatement-rowCount.xml PDOStatement-setAttribute.xml PDOStatement-setFetchMode.xml
| From: | Yannick Torres | Date: | Sun, 27 Nov 2005 12:18:21 +0000 |
| Subject: | cvs: phpdoc-fr /reference/pdo/functions PDOStatement-bindColumn.xml PDOStatement-bindParam.xml PDOStatement-closeCursor.xml PDOStatement-columnCount.xml PDOStatement-errorCode.xml PDOStatement-errorInfo.xml PDOStatement-execute.xml PDOStatement-fetch.xml PDOStatement-fetchAll.xml PDOStatement-fetchColumn.xml PDOStatement-getAttribute.xml PDOStatement-getColumnMeta.xml PDOStatement-nextRowset.xml PDOStatement-rowCount.xml PDOStatement-setAttribute.xml PDOStatement-setFetchMode.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-4644@lists.php.net to get a copy of this message | ||
yannick Sun Nov 27 07:18:21 2005 EDT
Modified files:
/phpdoc-fr/reference/pdo/functions PDOStatement-bindColumn.xml
PDOStatement-bindParam.xml
PDOStatement-closeCursor.xml
PDOStatement-columnCount.xml
PDOStatement-errorCode.xml
PDOStatement-errorInfo.xml
PDOStatement-execute.xml
PDOStatement-fetchAll.xml
PDOStatement-fetchColumn.xml
PDOStatement-fetch.xml
PDOStatement-getAttribute.xml
PDOStatement-getColumnMeta.xml
PDOStatement-nextRowset.xml
PDOStatement-rowCount.xml
PDOStatement-setAttribute.xml
PDOStatement-setFetchMode.xml
Log:
sync with EN
http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml:1.6 Mon Jul 11 13:07:58 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-bindColumn"> <refnamediv> <refname>PDOStatement::bindColumn</refname> @@ -17,7 +18,6 @@ <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> <function>PDOStatement::bindColumn</function> fait en sorte qu'une variable particulière soit liée à une colonne données dans le jeu de résultats @@ -61,7 +61,7 @@ <term><parameter>type</parameter></term> <listitem> <para> - Type du paramètre, spécifié par les constantes PDO_PARAM_*. + Type du paramètre, spécifié par les constantes PDO::PARAM_*. </para> </listitem> </varlistentry> @@ -97,7 +97,7 @@ /* Lie par les noms de colonnes */ $stmt->bindColumn('calories', $cals); - while ($row = $stmt->fetch(PDO_FETCH_BOUND)) { + while ($row = $stmt->fetch(PDO::FETCH_BOUND)) { $data = $nom . "\t" . $couleur . "\t" . $cals . "\n"; print $data; } http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml:1.6 Mon Jul 11 13:33:16 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-bindParam"> <refnamediv> <refname>PDOStatement::bindParam</refname> @@ -18,10 +19,12 @@ <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>driver_options</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - Lie un paramètre à un marquer nommé ou interrogatif correspondant dans une - requête SQL utilisée pour préparer la requête. + Lie une variable &php; à un marquer nommé ou interrogatif correspondant dans une + requête SQL utilisée pour préparer la requête. Contrairement à + <function>PDOStatement::bindValue</function>, la variable est liée en tant que + référence et ne sera évaluée qu'au moment de l'appel à la fonction + <function>PDOStatement::execute</function>. </para> <para> La plupart des paramètres sont des paramètres d'entrées, et sont utilisés @@ -63,8 +66,8 @@ <listitem> <para> Type explicite de données pour le paramètre utilisant la constante - PDO_PARAM_*. Pour retourner un paramètre INOUT depuis une procédure - stockée, utilisez l'opérateur OR pour définir l'octet PDO_PARAM_INPUT_OUTPUT + PDO::PARAM_*. Pour retourner un paramètre INOUT depuis une procédure + stockée, utilisez l'opérateur OR pour définir l'octet PDO::PARAM_INPUT_OUTPUT pour le paramètre <parameter>data_type</parameter> parameter. </para> </listitem> @@ -106,8 +109,8 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); -$sth->bindParam(':calories', $calories, PDO_PARAM_INT); -$sth->bindParam(':couleur', $couleur, PDO_PARAM_STR, 12); +$sth->bindParam(':calories', $calories, PDO::PARAM_INT); +$sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> @@ -128,8 +131,8 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); -$sth->bindParam(1, $calories, PDO_PARAM_INT); -$sth->bindParam(2, $couleur, PDO_PARAM_STR, 12); +$sth->bindParam(1, $calories, PDO::PARAM_INT); +$sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> @@ -148,10 +151,10 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); - $sth->bindParam(':calories', $calories, PDO_PARAM_INT); + $sth->bindParam(':calories', $calories, PDO::PARAM_INT); /* Trouver les fruits ayant une valeur NULL dans la colonne couleur */ - $sth->bindParam(':couleur', $couleur, PDO_PARAM_NULL); + $sth->bindParam(':couleur', $couleur, PDO::PARAM_NULL); $sth->execute(); ?> @@ -167,7 +170,7 @@ /* Appel une procédure stockée avec un paramètre INOUT */ $couleur = 'rouge'; $sth = $dbh->prepare('CALL puree_fruit(?)'); -$sth->bindParam(1, $couleur, PDO_PARAM_STR|PDO_PARAM_INPUT_OUTPUT, 12); +$sth->bindParam(1, $couleur, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 12); $sth->execute(); print("Après avoir pressé le fruit, la couleur est : $couleur"); ?> @@ -183,6 +186,7 @@ <simplelist> <member><function>PDO::prepare</function></member> <member><function>PDOStatement::execute</function></member> + <member><function>PDOStatement::bindValue</function></member> </simplelist> </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml:1.3 phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml:1.4 --- phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml:1.3 Tue Aug 30 04:07:08 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-closeCursor"> <refnamediv> <refname>PDOStatement::closeCursor</refname> @@ -15,8 +16,6 @@ <void/> </methodsynopsis> - &warn.experimental.func; - <para> <function>PDOStatement::closeCursor</function> libère la connexion du serveur, permettant ainsi à d'autres requêtes SQL d'être exécutées, mais @@ -108,7 +107,7 @@ $stmt = $dbh->prepare('SELECT foo FROM bar'); /* Création d'un second objet PDOStatement */ -$stmt = $dbh->prepare('SELECT foobaz FROM foobar'); +$otherStmt = $dbh->prepare('SELECT foobaz FROM foobar'); /* Exécute la première requête */ $stmt->execute(); http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml:1.2 phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml:1.3 --- phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml:1.2 Fri Jul 8 13:41:45 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-columnCount"> <refnamediv> <refname>PDOStatement::columnCount</refname> @@ -15,7 +16,6 @@ <void /> </methodsynopsis> - &warn.experimental.func; <para> Utilisez la fonction <function>PDOStatement::columnCount</function> pour retourner le nombre de colonnes dans le jeu de résultats représenté @@ -37,9 +37,9 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Retourne le nombre de colonnes dans le jeu de résultats représenté par - l'objet PDOStatement. S'il n'y a pas de jeu de résultats, - <function>PDOStatement::columnCount</function> retournera + Retourne le nombre de colonnes dans le jeu de résultats représenté par + l'objet PDOStatement. S'il n'y a pas de jeu de résultats, + <function>PDOStatement::columnCount</function> retournera &zero;. </para> </refsect1> @@ -118,4 +118,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml:1.6 Mon Jul 11 13:07:58 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-errorCode"> <refnamediv> <refname>PDOStatement::errorCode</refname> @@ -11,10 +12,9 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>PDOStatement::errorCode</methodname> + <type>string</type><methodname>PDOStatement::errorCode</methodname> <void/> </methodsynopsis> - &warn.experimental.func; </refsect1> <refsect1 role="returnvalues"> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml:1.5 phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml:1.6 --- phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml:1.5 Mon Feb 7 16:01:08 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-errorInfo"> <refnamediv> <refname>PDOStatement::errorInfo</refname> @@ -15,9 +16,8 @@ <void/> </methodsynopsis> - &warn.experimental.func; </refsect1> - + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -51,7 +51,7 @@ </informaltable> </para> </refsect1> - + <refsect1 role="examples"> &reftitle.examples; <para> @@ -119,4 +119,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml:1.5 phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml:1.6 --- phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml:1.5 Tue Aug 30 04:07:09 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-execute"> <refnamediv> <refname>PDOStatement::execute</refname> @@ -14,7 +15,6 @@ <type>bool</type><methodname>PDOStatement::execute</methodname> <methodparam choice="opt"><type>array</type><parameter>input_parameters</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> <function>PDOStatement::execute</function> exécute une requête préparée. Si la requête préparée inclue des marqueurs de positionnement, vous pouvez : @@ -40,8 +40,8 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); -$sth->bindParam(':calories', $calories, PDO_PARAM_INT); -$sth->bindParam(':couleur', $couleur, PDO_PARAM_STR, 12); +$sth->bindParam(':calories', $calories, PDO::PARAM_INT); +$sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> @@ -74,8 +74,8 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); -$sth->bindParam(1, $calories, PDO_PARAM_INT); -$sth->bindParam(2, $couleur, PDO_PARAM_STR, 12); +$sth->bindParam(1, $calories, PDO::PARAM_INT); +$sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml:1.6 Thu Sep 1 18:48:57 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-fetchAll"> <refnamediv> <refname>PDOStatement::fetchAll</refname> @@ -16,7 +17,6 @@ <methodparam choice="opt"><type>int</type><parameter>column_index</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; </refsect1> <refsect1 role="parameters"> @@ -29,21 +29,23 @@ <para> Contrôle le contenu du tableau retourné comme documenté dans la fonction <function>PDOStatement::fetch</function>. Vaut par défaut - <literal>PDO_FETCH_BOTH</literal>. + <literal>PDO::FETCH_BOTH</literal>. </para> <para> Pour retourner un tableau contenant toutes les valeurs d'une seule colonne - depuis le jeu de résultats, spécifiez <literal>PDO_FETCH_COLUMN</literal>. + depuis le jeu de résultats, spécifiez <literal>PDO::FETCH_COLUMN</literal>. + Vous pouvez spécifier quelle colonne vous voulez avec le paramètre + <parameter>column-index</parameter>. </para> <para> Pour récupérer uniquement les valeurs uniques d'une seule colonne depuis - le jeu de résultats, utilisez <literal>PDO_FETCH_COLUMN</literal> avec - <literal>PDO_FETCH_UNIQUE</literal>. + le jeu de résultats, utilisez <literal>PDO::FETCH_COLUMN</literal> avec + <literal>PDO::FETCH_UNIQUE</literal>. </para> <para> Pour retourner un tableau associatif groupé par les valeurs d'une - colonne spécifique, utilisez <literal>PDO_FETCH_COLUMN</literal> avec - <literal>PDO_FETCH_GROUP</literal>. + colonne spécifique, utilisez <literal>PDO::FETCH_COLUMN</literal> avec + <literal>PDO::FETCH_GROUP</literal>. </para> </listitem> </varlistentry> @@ -53,7 +55,7 @@ <para> Retourne la colonne indiquée où la valeur de <parameter>fetch_style</parameter> est - <literal>PDO_FETCH_COLUMN</literal>. Vaut par défaut <literal>0</literal>. + <literal>PDO::FETCH_COLUMN</literal>. Vaut par défaut <literal>0</literal>. </para> </listitem> </varlistentry> @@ -138,7 +140,7 @@ $sth->execute(); /* Récupération de toutes les valeurs de la première colonne */ -$result = $sth->fetchAll(PDO_FETCH_COLUMN, 0); +$result = $sth->fetchAll(PDO::FETCH_COLUMN, 0); var_dump($result); ?> ]]> @@ -180,7 +182,7 @@ $sth->execute(); /* Grouper les valeurs de la première colonne */ -var_dump($sth->fetchAll(PDO_FETCH_COLUMN|PDO_FETCH_GROUP)); +var_dump($sth->fetchAll(PDO::FETCH_COLUMN|PDO::FETCH_GROUP)); ?> ]]> </programlisting> @@ -248,4 +250,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml:1.2 phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml:1.3 --- phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml:1.2 Thu Jul 7 15:48:56 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-fetchColumn"> <refnamediv> <refname>PDOStatement::fetchColumn</refname> @@ -16,8 +17,6 @@ <methodparam choice="opt"><type>int</type><parameter>column_number</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; - <para> Retourne une colonne depuis la ligne suivante d'un jeu de résultats. </para> @@ -31,7 +30,7 @@ <term><parameter>column_number</parameter></term> <listitem> <para> - Numéro de la colonne que vous voulez récupérer depuis la ligne. + Numéro de la colonne que vous voulez récupérer depuis la ligne (commençant à 0). Si aucune valeur n'est fournie, <function>PDOStatement::fetchColumn</function> récupérera la première colonne. @@ -71,10 +70,11 @@ /* Récupère la première colonne depuis la ligne suivante d'un jeu de résultats */ print("Récupère la première colonne depuis la ligne suivante d'un jeu de résultats :\n"); $result = $sth->fetchColumn(); -print("$result\n"); +print("nom=$result\n"); +print("Récupère la deuxième colonne depuis la ligne suivante d'un jeu de résultats :\n"); $result = $sth->fetchColumn(); -print("$result\n"); +print("couleur=$result\n"); ?> ]]> </programlisting> @@ -82,8 +82,9 @@ <screen> <![CDATA[ Récupère la première colonne depuis la ligne suivante d'un jeu de résultats : -lemon -orange +nom=lemon +Récupère la deuxième colonne depuis la ligne suivante d'un jeu de résultats : +couleur=orange ]]> </screen> </example> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml:1.7 phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml:1.8 --- phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml:1.7 Sun Jun 26 17:57:18 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-fetch"> <refnamediv> <refname>PDOStatement::fetch</refname> @@ -17,10 +18,11 @@ <methodparam choice="opt"><type>int</type><parameter>cursor_offset</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> <function>PDOStatement::fetch</function> récupère une ligne depuis un jeu de résultats associé à l'objet <literal>PDOStatement</literal>. + Le paramètre <parameter>fetch_style</parameter> détermine la façon dont PDO retourne + la ligne. </para> </refsect1> @@ -33,39 +35,49 @@ <listitem> <para> Contrôle comment la prochaine ligne sera retournée à l'appelant. Cette valeur - doit être une des constantes <literal>PDO_FETCH_*</literal>, - et par défaut, vaut <literal>PDO_FETCH_BOTH</literal>. + doit être une des constantes <literal>PDO::FETCH_*</literal>, + et par défaut, vaut <literal>PDO::FETCH_BOTH</literal>. <itemizedlist> <listitem><para> - <literal>PDO_FETCH_ASSOC</literal>: retourne un tableau indexé par le nom + <literal>PDO::FETCH_ASSOC</literal>: retourne un tableau indexé par le nom de la colonne comme retourné dans le jeu de résultats </para></listitem> <listitem><para> <literal>PDO_FETCH_BOTH</literal> (défaut): retourne un tableau indexé - par les noms de colonnes mais aussi les numéros de colonnes, comme - retournés dans le jeu de résultats + par les noms de colonnes mais aussi par les numéros de colonnes (commençant à l'indice 0), + comme retournés dans le jeu de résultats </para></listitem> <listitem><para> - <literal>PDO_FETCH_BOUND</literal>: retourne &true; et assigne les valeurs + <literal>PDO::FETCH_BOUND</literal>: retourne &true; et assigne les valeurs des colonnes de votre jeu de résultats dans les variables &php; à laquelles elles sont liées avec la méthode <function>PDOStatement::bindParam</function> </para></listitem> <listitem><para> - <literal>PDO_FETCH_LAZY</literal>: combine - <literal>PDO_FETCH_BOTH</literal> et <literal>PDO_FETCH_OBJ</literal>, - créant ainsi les noms des variables de l'objet, comme elles sont accédées + <literal>PDO::FETCH_CLASS</literal>: retourne une nouvelle instance + de la classe demandée, liant les colonnes du jeu de résultats aux noms des + propriétés de la classe </para></listitem> <listitem><para> - <literal>PDO_FETCH_OBJ</literal>: retourne un objet anonyme avec les - noms de propriétés qui correspondent aux noms de colonnes retournés dans le - jeu de résultats + <literal>PDO::FETCH_INTO</literal>: met à jour une instance existante + de la classe demandée, liant les colonnes du jeu de résultats aux noms des propriétés + de la classe + </para></listitem> + <listitem><para> + <literal>PDO::FETCH_LAZY</literal>: combine + <literal>PDO::FETCH_BOTH</literal> et <literal>PDO::FETCH_OBJ</literal>, + créant ainsi les noms des variables de l'objet, comme elles sont accédées </para></listitem> <listitem><para> - <literal>PDO_FETCH_NUM</literal>: retourne un tableau indexé par le - numéro de la colonne comme elle est retourné dans votre jeu de résultat, + <literal>PDO::FETCH_NUM</literal>: retourne un tableau indexé par le + numéro de la colonne comme elle est retourné dans votre jeu de résultat, commençant à 0 </para></listitem> + <listitem><para> + <literal>PDO_FETCH_OBJ</literal>: retourne un objet anonyme avec les + noms de propriétés qui correspondent aux noms des colonnes retournés dans le + jeu de résultats + </para></listitem> </itemizedlist> </para> </listitem> @@ -77,8 +89,12 @@ Pour un objet PDOStatement représentant un curseur scrollable, cette valeur détermine quelle ligne sera retournée à l'appelant. Cette valeur doit être une des constantes - <literal>PDO_FETCH_ORI_*</literal>, et par défaut, vaut - <literal>PDO_FETCH_ORI_NEXT</literal>. + <literal>PDO::FETCH_ORI_*</literal>, et par défaut, vaut + <literal>PDO::FETCH_ORI_NEXT</literal>. Pour demander un curseur + scrollable pour votre objet PDOStatement, vous devez définir + l'attribut <literal>PDO::ATTR_CURSOR</literal> à <literal>PDO::CURSOR_SCROLL</literal> + lorsque vous préparez la requête SQL avec la fonction + <function>PDO::prepare</function>. </para> </listitem> </varlistentry> @@ -88,14 +104,14 @@ <para> Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre <literal>cursor_orientation</literal> est défini - à <literal>PDO_FETCH_ORI_ABS</literal>, cette valeur spécifie + à <literal>PDO::FETCH_ORI_ABS</literal>, cette valeur spécifie le numéro absolu de la ligne dans le jeu de résultats qui doit être récupérée. </para> <para> Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre <literal>cursor_orientation</literal> est défini - à <literal>PDO_FETCH_ORI_REL</literal>, cette valeur spécifie la ligne + à <literal>PDO::FETCH_ORI_REL</literal>, cette valeur spécifie la ligne à récupérer relativement à la position du curseur avant l'appel à la fonction <function>PDOStatement::fetch</function>. </para> @@ -117,27 +133,27 @@ $sth->execute(); /* styles PDOStatement::fetch */ -print("PDO_FETCH_ASSOC: "); +print("PDO::FETCH_ASSOC: "); print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes\n"); -$result = $sth->fetch(PDO_FETCH_ASSOC); +$result = $sth->fetch(PDO::FETCH_ASSOC); print_r($result); print("\n"); -print("PDO_FETCH_BOTH: "); +print("PDO::FETCH_BOTH: "); print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne\n"); -$result = $sth->fetch(PDO_FETCH_BOTH); +$result = $sth->fetch(PDO::FETCH_BOTH); print_r($result); print("\n"); -print("PDO_FETCH_LAZY: "); +print("PDO::FETCH_LAZY: "); print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n"); -$result = $sth->fetch(PDO_FETCH_LAZY); +$result = $sth->fetch(PDO::FETCH_LAZY); print_r($result); print("\n"); -print("PDO_FETCH_OBJ: "); +print("PDO::FETCH_OBJ: "); print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n"); -$result = $sth->fetch(PDO_FETCH_OBJ); +$result = $sth->fetch(PDO::FETCH_OBJ); print $result->NAME; print("\n"); ?> @@ -146,14 +162,14 @@ &example.outputs; <screen> <![CDATA[ -PDO_FETCH_ASSOC: Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes +PDO::FETCH_ASSOC: Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes Array ( [NOM] => apple [COULEUR] => red ) -PDO_FETCH_BOTH: Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne +PDO::FETCH_BOTH: Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne Array ( [NOM] => banana @@ -162,15 +178,13 @@ [1] => yellow ) -PDO_FETCH_LAZY: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés -PDORow Object +PDO::FETCH_LAZY: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés PDORow Object ( [NOM] => orange [COULEUR] => orange ) -PDO_FETCH_OBJ: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés -kiwi +PDO::FETCH_OBJ: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés kiwi ]]> </screen> </example> @@ -182,9 +196,9 @@ function readDataForwards($dbh) { $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY BET'; try { - $stmt = $dbh->prepare($sql, array(PDO_ATTR_CURSOR, PDO_CURSOR_SCROLL)); + $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR, PDO::CURSOR_SCROLL)); $stmt->execute(); - while ($row = $stmt->fetch(PDO_FETCH_NUM, PDO_FETCH_ORI_NEXT)) { + while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_NEXT)) { $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; print $data; } @@ -197,13 +211,13 @@ function readDataBackwards($dbh) { $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY bet'; try { - $stmt = $dbh->prepare($sql, array(PDO_ATTR_CURSOR, PDO_CURSOR_SCROLL)); + $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR, PDO::CURSOR_SCROLL)); $stmt->execute(); - $row = $stmt->fetch(PDO_FETCH_NUM, PDO_FETCH_ORI_LAST); + $row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_LAST); do { $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; print $data; - } while ($row = $stmt->fetch(PDO_FETCH_NUM, PDO_FETCH_ORI_PRIOR)); + } while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_PRIOR)); $stmt = null; } catch (PDOException $e) { @@ -226,7 +240,7 @@ 21 10 5 16 0 5 19 20 10 - + Lecture en arrière : 19 20 10 16 0 5 @@ -271,4 +285,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml:1.2 phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml:1.3 --- phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml:1.2 Sun Jun 26 17:57:18 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-getAttribute"> <refnamediv> <refname>PDOStatement::getAttribute</refname> @@ -15,7 +16,16 @@ <methodparam><type>int</type><parameter>attribute</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; + <para> + Récupère un attribut de la requête. Actuellement, aucun attribut générique n'existe, mais uniquement + des spécificités du driver : + <itemizedlist> + <listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal> + (spécificité de Firebird et d'ODBC) : + Récupère le nom du curseur pour <literal>UPDATE ... WHERE CURRENT OF</literal>. + </para></listitem> + </itemizedlist> + </para> </refsect1> @@ -107,4 +117,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml:1.4 phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml:1.5 --- phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml:1.4 Fri Jul 8 13:41:45 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-getColumnMeta"> <refnamediv> <refname>PDOStatement::getColumnMeta</refname> @@ -94,7 +95,7 @@ <row> <entry><literal>pdo_type</literal></entry> <entry>Le type de cette colonne comme représenté par la constante - <literal>PDO_PARAM_*</literal> constants.</entry> + <literal>PDO::PARAM_*</literal> constants.</entry> </row> </tbody> </tgroup> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml:1.1 phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml:1.2 --- phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml:1.1 Sun Jun 26 18:15:49 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-nextRowset"> <refnamediv> <refname>PDOStatement::nextRowset</refname> @@ -15,8 +16,6 @@ <void/> </methodsynopsis> - &warn.experimental.func; - <para> Quelques bases de données supportent les procédures stockées qui retournent plus d'une ligne de résultats (aussi connu comme des jeux de résultats). @@ -54,7 +53,7 @@ $stmt = $conn->query($sql); $i = 1; do { - $rowset = $stmt->fetchAll(PDO_FETCH_NUM); + $rowset = $stmt->fetchAll(PDO::FETCH_NUM); if ($rowset) { printResultSet($rowset, $i); } @@ -129,4 +128,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml:1.6 Tue Aug 30 04:07:09 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-rowCount"> <refnamediv> <refname>PDOStatement::rowCount</refname> @@ -16,7 +17,6 @@ <void/> </methodsynopsis> - &warn.experimental.func; <para> <function>PDOStatement::rowCount</function> retourne le nombre de lignes affectées par la dernière requête DELETE, INSERT ou UPDATE exécutée par http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml:1.2 phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml:1.3 --- phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml:1.2 Sun Jun 26 17:57:18 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <refentry id="function.PDOStatement-setAttribute"> <refnamediv> <refname>PDOStatement::setAttribute</refname> @@ -16,7 +16,16 @@ <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; + <para> + Définit un attribut de la requête. Actuellement, aucun attribut générique n'est défini, mais uniquement + des spécificités du driver : + <itemizedlist> + <listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal> + (spécificité de Firebird et d'ODBC) : + Définit le nom du curseur pour <literal>UPDATE ... WHERE CURRENT OF</literal>. + </para></listitem> + </itemizedlist> + </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml:1.4 phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml:1.5 --- phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml:1.4 Fri Jul 8 13:47:44 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-setFetchMode"> <refnamediv> <refname>PDOStatement::setFetchMode</refname> @@ -15,8 +16,6 @@ <methodparam><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; - </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -27,7 +26,7 @@ <listitem> <para> Le mode de récupération doit être une des constantes - <literal>PDO_FETCH_*</literal>. + <literal>PDO::FETCH_*</literal>. </para> </listitem> </varlistentry> @@ -58,7 +57,7 @@ $sql = 'SELECT name, colour, calories FROM fruit'; try { $stmt = $dbh->query($sql); - $result = $stmt->setFetchMode(PDO_FETCH_NUM); + $result = $stmt->setFetchMode(PDO::FETCH_NUM); while ($row = $stmt->fetch()) { print $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; } @@ -105,4 +104,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file
http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml:1.6 Mon Jul 11 13:07:58 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-bindColumn.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-bindColumn"> <refnamediv> <refname>PDOStatement::bindColumn</refname> @@ -17,7 +18,6 @@ <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> <function>PDOStatement::bindColumn</function> fait en sorte qu'une variable particulière soit liée à une colonne données dans le jeu de résultats @@ -61,7 +61,7 @@ <term><parameter>type</parameter></term> <listitem> <para> - Type du paramètre, spécifié par les constantes PDO_PARAM_*. + Type du paramètre, spécifié par les constantes PDO::PARAM_*. </para> </listitem> </varlistentry> @@ -97,7 +97,7 @@ /* Lie par les noms de colonnes */ $stmt->bindColumn('calories', $cals); - while ($row = $stmt->fetch(PDO_FETCH_BOUND)) { + while ($row = $stmt->fetch(PDO::FETCH_BOUND)) { $data = $nom . "\t" . $couleur . "\t" . $cals . "\n"; print $data; } http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml:1.6 Mon Jul 11 13:33:16 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-bindParam.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-bindParam"> <refnamediv> <refname>PDOStatement::bindParam</refname> @@ -18,10 +19,12 @@ <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>driver_options</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> - Lie un paramètre à un marquer nommé ou interrogatif correspondant dans une - requête SQL utilisée pour préparer la requête. + Lie une variable &php; à un marquer nommé ou interrogatif correspondant dans une + requête SQL utilisée pour préparer la requête. Contrairement à + <function>PDOStatement::bindValue</function>, la variable est liée en tant que + référence et ne sera évaluée qu'au moment de l'appel à la fonction + <function>PDOStatement::execute</function>. </para> <para> La plupart des paramètres sont des paramètres d'entrées, et sont utilisés @@ -63,8 +66,8 @@ <listitem> <para> Type explicite de données pour le paramètre utilisant la constante - PDO_PARAM_*. Pour retourner un paramètre INOUT depuis une procédure - stockée, utilisez l'opérateur OR pour définir l'octet PDO_PARAM_INPUT_OUTPUT + PDO::PARAM_*. Pour retourner un paramètre INOUT depuis une procédure + stockée, utilisez l'opérateur OR pour définir l'octet PDO::PARAM_INPUT_OUTPUT pour le paramètre <parameter>data_type</parameter> parameter. </para> </listitem> @@ -106,8 +109,8 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); -$sth->bindParam(':calories', $calories, PDO_PARAM_INT); -$sth->bindParam(':couleur', $couleur, PDO_PARAM_STR, 12); +$sth->bindParam(':calories', $calories, PDO::PARAM_INT); +$sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> @@ -128,8 +131,8 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); -$sth->bindParam(1, $calories, PDO_PARAM_INT); -$sth->bindParam(2, $couleur, PDO_PARAM_STR, 12); +$sth->bindParam(1, $calories, PDO::PARAM_INT); +$sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> @@ -148,10 +151,10 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); - $sth->bindParam(':calories', $calories, PDO_PARAM_INT); + $sth->bindParam(':calories', $calories, PDO::PARAM_INT); /* Trouver les fruits ayant une valeur NULL dans la colonne couleur */ - $sth->bindParam(':couleur', $couleur, PDO_PARAM_NULL); + $sth->bindParam(':couleur', $couleur, PDO::PARAM_NULL); $sth->execute(); ?> @@ -167,7 +170,7 @@ /* Appel une procédure stockée avec un paramètre INOUT */ $couleur = 'rouge'; $sth = $dbh->prepare('CALL puree_fruit(?)'); -$sth->bindParam(1, $couleur, PDO_PARAM_STR|PDO_PARAM_INPUT_OUTPUT, 12); +$sth->bindParam(1, $couleur, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 12); $sth->execute(); print("Après avoir pressé le fruit, la couleur est : $couleur"); ?> @@ -183,6 +186,7 @@ <simplelist> <member><function>PDO::prepare</function></member> <member><function>PDOStatement::execute</function></member> + <member><function>PDOStatement::bindValue</function></member> </simplelist> </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml:1.3 phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml:1.4 --- phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml:1.3 Tue Aug 30 04:07:08 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-closeCursor.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-closeCursor"> <refnamediv> <refname>PDOStatement::closeCursor</refname> @@ -15,8 +16,6 @@ <void/> </methodsynopsis> - &warn.experimental.func; - <para> <function>PDOStatement::closeCursor</function> libère la connexion du serveur, permettant ainsi à d'autres requêtes SQL d'être exécutées, mais @@ -108,7 +107,7 @@ $stmt = $dbh->prepare('SELECT foo FROM bar'); /* Création d'un second objet PDOStatement */ -$stmt = $dbh->prepare('SELECT foobaz FROM foobar'); +$otherStmt = $dbh->prepare('SELECT foobaz FROM foobar'); /* Exécute la première requête */ $stmt->execute(); http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml:1.2 phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml:1.3 --- phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml:1.2 Fri Jul 8 13:41:45 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-columnCount.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-columnCount"> <refnamediv> <refname>PDOStatement::columnCount</refname> @@ -15,7 +16,6 @@ <void /> </methodsynopsis> - &warn.experimental.func; <para> Utilisez la fonction <function>PDOStatement::columnCount</function> pour retourner le nombre de colonnes dans le jeu de résultats représenté @@ -37,9 +37,9 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Retourne le nombre de colonnes dans le jeu de résultats représenté par - l'objet PDOStatement. S'il n'y a pas de jeu de résultats, - <function>PDOStatement::columnCount</function> retournera + Retourne le nombre de colonnes dans le jeu de résultats représenté par + l'objet PDOStatement. S'il n'y a pas de jeu de résultats, + <function>PDOStatement::columnCount</function> retournera &zero;. </para> </refsect1> @@ -118,4 +118,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml:1.6 Mon Jul 11 13:07:58 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-errorCode.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-errorCode"> <refnamediv> <refname>PDOStatement::errorCode</refname> @@ -11,10 +12,9 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>PDOStatement::errorCode</methodname> + <type>string</type><methodname>PDOStatement::errorCode</methodname> <void/> </methodsynopsis> - &warn.experimental.func; </refsect1> <refsect1 role="returnvalues"> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml:1.5 phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml:1.6 --- phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml:1.5 Mon Feb 7 16:01:08 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-errorInfo.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-errorInfo"> <refnamediv> <refname>PDOStatement::errorInfo</refname> @@ -15,9 +16,8 @@ <void/> </methodsynopsis> - &warn.experimental.func; </refsect1> - + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -51,7 +51,7 @@ </informaltable> </para> </refsect1> - + <refsect1 role="examples"> &reftitle.examples; <para> @@ -119,4 +119,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml:1.5 phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml:1.6 --- phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml:1.5 Tue Aug 30 04:07:09 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-execute.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-execute"> <refnamediv> <refname>PDOStatement::execute</refname> @@ -14,7 +15,6 @@ <type>bool</type><methodname>PDOStatement::execute</methodname> <methodparam choice="opt"><type>array</type><parameter>input_parameters</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> <function>PDOStatement::execute</function> exécute une requête préparée. Si la requête préparée inclue des marqueurs de positionnement, vous pouvez : @@ -40,8 +40,8 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); -$sth->bindParam(':calories', $calories, PDO_PARAM_INT); -$sth->bindParam(':couleur', $couleur, PDO_PARAM_STR, 12); +$sth->bindParam(':calories', $calories, PDO::PARAM_INT); +$sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> @@ -74,8 +74,8 @@ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); -$sth->bindParam(1, $calories, PDO_PARAM_INT); -$sth->bindParam(2, $couleur, PDO_PARAM_STR, 12); +$sth->bindParam(1, $calories, PDO::PARAM_INT); +$sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml:1.6 Thu Sep 1 18:48:57 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-fetchAll.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-fetchAll"> <refnamediv> <refname>PDOStatement::fetchAll</refname> @@ -16,7 +17,6 @@ <methodparam choice="opt"><type>int</type><parameter>column_index</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; </refsect1> <refsect1 role="parameters"> @@ -29,21 +29,23 @@ <para> Contrôle le contenu du tableau retourné comme documenté dans la fonction <function>PDOStatement::fetch</function>. Vaut par défaut - <literal>PDO_FETCH_BOTH</literal>. + <literal>PDO::FETCH_BOTH</literal>. </para> <para> Pour retourner un tableau contenant toutes les valeurs d'une seule colonne - depuis le jeu de résultats, spécifiez <literal>PDO_FETCH_COLUMN</literal>. + depuis le jeu de résultats, spécifiez <literal>PDO::FETCH_COLUMN</literal>. + Vous pouvez spécifier quelle colonne vous voulez avec le paramètre + <parameter>column-index</parameter>. </para> <para> Pour récupérer uniquement les valeurs uniques d'une seule colonne depuis - le jeu de résultats, utilisez <literal>PDO_FETCH_COLUMN</literal> avec - <literal>PDO_FETCH_UNIQUE</literal>. + le jeu de résultats, utilisez <literal>PDO::FETCH_COLUMN</literal> avec + <literal>PDO::FETCH_UNIQUE</literal>. </para> <para> Pour retourner un tableau associatif groupé par les valeurs d'une - colonne spécifique, utilisez <literal>PDO_FETCH_COLUMN</literal> avec - <literal>PDO_FETCH_GROUP</literal>. + colonne spécifique, utilisez <literal>PDO::FETCH_COLUMN</literal> avec + <literal>PDO::FETCH_GROUP</literal>. </para> </listitem> </varlistentry> @@ -53,7 +55,7 @@ <para> Retourne la colonne indiquée où la valeur de <parameter>fetch_style</parameter> est - <literal>PDO_FETCH_COLUMN</literal>. Vaut par défaut <literal>0</literal>. + <literal>PDO::FETCH_COLUMN</literal>. Vaut par défaut <literal>0</literal>. </para> </listitem> </varlistentry> @@ -138,7 +140,7 @@ $sth->execute(); /* Récupération de toutes les valeurs de la première colonne */ -$result = $sth->fetchAll(PDO_FETCH_COLUMN, 0); +$result = $sth->fetchAll(PDO::FETCH_COLUMN, 0); var_dump($result); ?> ]]> @@ -180,7 +182,7 @@ $sth->execute(); /* Grouper les valeurs de la première colonne */ -var_dump($sth->fetchAll(PDO_FETCH_COLUMN|PDO_FETCH_GROUP)); +var_dump($sth->fetchAll(PDO::FETCH_COLUMN|PDO::FETCH_GROUP)); ?> ]]> </programlisting> @@ -248,4 +250,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml:1.2 phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml:1.3 --- phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml:1.2 Thu Jul 7 15:48:56 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-fetchColumn.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-fetchColumn"> <refnamediv> <refname>PDOStatement::fetchColumn</refname> @@ -16,8 +17,6 @@ <methodparam choice="opt"><type>int</type><parameter>column_number</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; - <para> Retourne une colonne depuis la ligne suivante d'un jeu de résultats. </para> @@ -31,7 +30,7 @@ <term><parameter>column_number</parameter></term> <listitem> <para> - Numéro de la colonne que vous voulez récupérer depuis la ligne. + Numéro de la colonne que vous voulez récupérer depuis la ligne (commençant à 0). Si aucune valeur n'est fournie, <function>PDOStatement::fetchColumn</function> récupérera la première colonne. @@ -71,10 +70,11 @@ /* Récupère la première colonne depuis la ligne suivante d'un jeu de résultats */ print("Récupère la première colonne depuis la ligne suivante d'un jeu de résultats :\n"); $result = $sth->fetchColumn(); -print("$result\n"); +print("nom=$result\n"); +print("Récupère la deuxième colonne depuis la ligne suivante d'un jeu de résultats :\n"); $result = $sth->fetchColumn(); -print("$result\n"); +print("couleur=$result\n"); ?> ]]> </programlisting> @@ -82,8 +82,9 @@ <screen> <![CDATA[ Récupère la première colonne depuis la ligne suivante d'un jeu de résultats : -lemon -orange +nom=lemon +Récupère la deuxième colonne depuis la ligne suivante d'un jeu de résultats : +couleur=orange ]]> </screen> </example> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml:1.7 phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml:1.8 --- phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml:1.7 Sun Jun 26 17:57:18 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-fetch.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-fetch"> <refnamediv> <refname>PDOStatement::fetch</refname> @@ -17,10 +18,11 @@ <methodparam choice="opt"><type>int</type><parameter>cursor_offset</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; <para> <function>PDOStatement::fetch</function> récupère une ligne depuis un jeu de résultats associé à l'objet <literal>PDOStatement</literal>. + Le paramètre <parameter>fetch_style</parameter> détermine la façon dont PDO retourne + la ligne. </para> </refsect1> @@ -33,39 +35,49 @@ <listitem> <para> Contrôle comment la prochaine ligne sera retournée à l'appelant. Cette valeur - doit être une des constantes <literal>PDO_FETCH_*</literal>, - et par défaut, vaut <literal>PDO_FETCH_BOTH</literal>. + doit être une des constantes <literal>PDO::FETCH_*</literal>, + et par défaut, vaut <literal>PDO::FETCH_BOTH</literal>. <itemizedlist> <listitem><para> - <literal>PDO_FETCH_ASSOC</literal>: retourne un tableau indexé par le nom + <literal>PDO::FETCH_ASSOC</literal>: retourne un tableau indexé par le nom de la colonne comme retourné dans le jeu de résultats </para></listitem> <listitem><para> <literal>PDO_FETCH_BOTH</literal> (défaut): retourne un tableau indexé - par les noms de colonnes mais aussi les numéros de colonnes, comme - retournés dans le jeu de résultats + par les noms de colonnes mais aussi par les numéros de colonnes (commençant à l'indice 0), + comme retournés dans le jeu de résultats </para></listitem> <listitem><para> - <literal>PDO_FETCH_BOUND</literal>: retourne &true; et assigne les valeurs + <literal>PDO::FETCH_BOUND</literal>: retourne &true; et assigne les valeurs des colonnes de votre jeu de résultats dans les variables &php; à laquelles elles sont liées avec la méthode <function>PDOStatement::bindParam</function> </para></listitem> <listitem><para> - <literal>PDO_FETCH_LAZY</literal>: combine - <literal>PDO_FETCH_BOTH</literal> et <literal>PDO_FETCH_OBJ</literal>, - créant ainsi les noms des variables de l'objet, comme elles sont accédées + <literal>PDO::FETCH_CLASS</literal>: retourne une nouvelle instance + de la classe demandée, liant les colonnes du jeu de résultats aux noms des + propriétés de la classe </para></listitem> <listitem><para> - <literal>PDO_FETCH_OBJ</literal>: retourne un objet anonyme avec les - noms de propriétés qui correspondent aux noms de colonnes retournés dans le - jeu de résultats + <literal>PDO::FETCH_INTO</literal>: met à jour une instance existante + de la classe demandée, liant les colonnes du jeu de résultats aux noms des propriétés + de la classe + </para></listitem> + <listitem><para> + <literal>PDO::FETCH_LAZY</literal>: combine + <literal>PDO::FETCH_BOTH</literal> et <literal>PDO::FETCH_OBJ</literal>, + créant ainsi les noms des variables de l'objet, comme elles sont accédées </para></listitem> <listitem><para> - <literal>PDO_FETCH_NUM</literal>: retourne un tableau indexé par le - numéro de la colonne comme elle est retourné dans votre jeu de résultat, + <literal>PDO::FETCH_NUM</literal>: retourne un tableau indexé par le + numéro de la colonne comme elle est retourné dans votre jeu de résultat, commençant à 0 </para></listitem> + <listitem><para> + <literal>PDO_FETCH_OBJ</literal>: retourne un objet anonyme avec les + noms de propriétés qui correspondent aux noms des colonnes retournés dans le + jeu de résultats + </para></listitem> </itemizedlist> </para> </listitem> @@ -77,8 +89,12 @@ Pour un objet PDOStatement représentant un curseur scrollable, cette valeur détermine quelle ligne sera retournée à l'appelant. Cette valeur doit être une des constantes - <literal>PDO_FETCH_ORI_*</literal>, et par défaut, vaut - <literal>PDO_FETCH_ORI_NEXT</literal>. + <literal>PDO::FETCH_ORI_*</literal>, et par défaut, vaut + <literal>PDO::FETCH_ORI_NEXT</literal>. Pour demander un curseur + scrollable pour votre objet PDOStatement, vous devez définir + l'attribut <literal>PDO::ATTR_CURSOR</literal> à <literal>PDO::CURSOR_SCROLL</literal> + lorsque vous préparez la requête SQL avec la fonction + <function>PDO::prepare</function>. </para> </listitem> </varlistentry> @@ -88,14 +104,14 @@ <para> Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre <literal>cursor_orientation</literal> est défini - à <literal>PDO_FETCH_ORI_ABS</literal>, cette valeur spécifie + à <literal>PDO::FETCH_ORI_ABS</literal>, cette valeur spécifie le numéro absolu de la ligne dans le jeu de résultats qui doit être récupérée. </para> <para> Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre <literal>cursor_orientation</literal> est défini - à <literal>PDO_FETCH_ORI_REL</literal>, cette valeur spécifie la ligne + à <literal>PDO::FETCH_ORI_REL</literal>, cette valeur spécifie la ligne à récupérer relativement à la position du curseur avant l'appel à la fonction <function>PDOStatement::fetch</function>. </para> @@ -117,27 +133,27 @@ $sth->execute(); /* styles PDOStatement::fetch */ -print("PDO_FETCH_ASSOC: "); +print("PDO::FETCH_ASSOC: "); print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes\n"); -$result = $sth->fetch(PDO_FETCH_ASSOC); +$result = $sth->fetch(PDO::FETCH_ASSOC); print_r($result); print("\n"); -print("PDO_FETCH_BOTH: "); +print("PDO::FETCH_BOTH: "); print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne\n"); -$result = $sth->fetch(PDO_FETCH_BOTH); +$result = $sth->fetch(PDO::FETCH_BOTH); print_r($result); print("\n"); -print("PDO_FETCH_LAZY: "); +print("PDO::FETCH_LAZY: "); print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n"); -$result = $sth->fetch(PDO_FETCH_LAZY); +$result = $sth->fetch(PDO::FETCH_LAZY); print_r($result); print("\n"); -print("PDO_FETCH_OBJ: "); +print("PDO::FETCH_OBJ: "); print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n"); -$result = $sth->fetch(PDO_FETCH_OBJ); +$result = $sth->fetch(PDO::FETCH_OBJ); print $result->NAME; print("\n"); ?> @@ -146,14 +162,14 @@ &example.outputs; <screen> <![CDATA[ -PDO_FETCH_ASSOC: Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes +PDO::FETCH_ASSOC: Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes Array ( [NOM] => apple [COULEUR] => red ) -PDO_FETCH_BOTH: Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne +PDO::FETCH_BOTH: Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne Array ( [NOM] => banana @@ -162,15 +178,13 @@ [1] => yellow ) -PDO_FETCH_LAZY: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés -PDORow Object +PDO::FETCH_LAZY: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés PDORow Object ( [NOM] => orange [COULEUR] => orange ) -PDO_FETCH_OBJ: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés -kiwi +PDO::FETCH_OBJ: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés kiwi ]]> </screen> </example> @@ -182,9 +196,9 @@ function readDataForwards($dbh) { $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY BET'; try { - $stmt = $dbh->prepare($sql, array(PDO_ATTR_CURSOR, PDO_CURSOR_SCROLL)); + $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR, PDO::CURSOR_SCROLL)); $stmt->execute(); - while ($row = $stmt->fetch(PDO_FETCH_NUM, PDO_FETCH_ORI_NEXT)) { + while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_NEXT)) { $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; print $data; } @@ -197,13 +211,13 @@ function readDataBackwards($dbh) { $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY bet'; try { - $stmt = $dbh->prepare($sql, array(PDO_ATTR_CURSOR, PDO_CURSOR_SCROLL)); + $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR, PDO::CURSOR_SCROLL)); $stmt->execute(); - $row = $stmt->fetch(PDO_FETCH_NUM, PDO_FETCH_ORI_LAST); + $row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_LAST); do { $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; print $data; - } while ($row = $stmt->fetch(PDO_FETCH_NUM, PDO_FETCH_ORI_PRIOR)); + } while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_PRIOR)); $stmt = null; } catch (PDOException $e) { @@ -226,7 +240,7 @@ 21 10 5 16 0 5 19 20 10 - + Lecture en arrière : 19 20 10 16 0 5 @@ -271,4 +285,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml:1.2 phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml:1.3 --- phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml:1.2 Sun Jun 26 17:57:18 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-getAttribute.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-getAttribute"> <refnamediv> <refname>PDOStatement::getAttribute</refname> @@ -15,7 +16,16 @@ <methodparam><type>int</type><parameter>attribute</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; + <para> + Récupère un attribut de la requête. Actuellement, aucun attribut générique n'existe, mais uniquement + des spécificités du driver : + <itemizedlist> + <listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal> + (spécificité de Firebird et d'ODBC) : + Récupère le nom du curseur pour <literal>UPDATE ... WHERE CURRENT OF</literal>. + </para></listitem> + </itemizedlist> + </para> </refsect1> @@ -107,4 +117,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml:1.4 phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml:1.5 --- phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml:1.4 Fri Jul 8 13:41:45 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-getColumnMeta.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-getColumnMeta"> <refnamediv> <refname>PDOStatement::getColumnMeta</refname> @@ -94,7 +95,7 @@ <row> <entry><literal>pdo_type</literal></entry> <entry>Le type de cette colonne comme représenté par la constante - <literal>PDO_PARAM_*</literal> constants.</entry> + <literal>PDO::PARAM_*</literal> constants.</entry> </row> </tbody> </tgroup> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml:1.1 phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml:1.2 --- phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml:1.1 Sun Jun 26 18:15:49 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-nextRowset.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-nextRowset"> <refnamediv> <refname>PDOStatement::nextRowset</refname> @@ -15,8 +16,6 @@ <void/> </methodsynopsis> - &warn.experimental.func; - <para> Quelques bases de données supportent les procédures stockées qui retournent plus d'une ligne de résultats (aussi connu comme des jeux de résultats). @@ -54,7 +53,7 @@ $stmt = $conn->query($sql); $i = 1; do { - $rowset = $stmt->fetchAll(PDO_FETCH_NUM); + $rowset = $stmt->fetchAll(PDO::FETCH_NUM); if ($rowset) { printResultSet($rowset, $i); } @@ -129,4 +128,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml:1.6 phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml:1.7 --- phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml:1.6 Tue Aug 30 04:07:09 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-rowCount.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-rowCount"> <refnamediv> <refname>PDOStatement::rowCount</refname> @@ -16,7 +17,6 @@ <void/> </methodsynopsis> - &warn.experimental.func; <para> <function>PDOStatement::rowCount</function> retourne le nombre de lignes affectées par la dernière requête DELETE, INSERT ou UPDATE exécutée par http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml:1.2 phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml:1.3 --- phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml:1.2 Sun Jun 26 17:57:18 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-setAttribute.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <refentry id="function.PDOStatement-setAttribute"> <refnamediv> <refname>PDOStatement::setAttribute</refname> @@ -16,7 +16,16 @@ <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; + <para> + Définit un attribut de la requête. Actuellement, aucun attribut générique n'est défini, mais uniquement + des spécificités du driver : + <itemizedlist> + <listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal> + (spécificité de Firebird et d'ODBC) : + Définit le nom du curseur pour <literal>UPDATE ... WHERE CURRENT OF</literal>. + </para></listitem> + </itemizedlist> + </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml diff -u phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml:1.4 phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml:1.5 --- phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml:1.4 Fri Jul 8 13:47:44 2005 +++ phpdoc-fr/reference/pdo/functions/PDOStatement-setFetchMode.xml Sun Nov 27 07:18:20 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> + <refentry id="function.PDOStatement-setFetchMode"> <refnamediv> <refname>PDOStatement::setFetchMode</refname> @@ -15,8 +16,6 @@ <methodparam><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> - &warn.experimental.func; - </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -27,7 +26,7 @@ <listitem> <para> Le mode de récupération doit être une des constantes - <literal>PDO_FETCH_*</literal>. + <literal>PDO::FETCH_*</literal>. </para> </listitem> </varlistentry> @@ -58,7 +57,7 @@ $sql = 'SELECT name, colour, calories FROM fruit'; try { $stmt = $dbh->query($sql); - $result = $stmt->setFetchMode(PDO_FETCH_NUM); + $result = $stmt->setFetchMode(PDO::FETCH_NUM); while ($row = $stmt->fetch()) { print $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; } @@ -105,4 +104,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file