cvs: phpdoc-fr /reference/mysqli/functions mysqli-fetch-array.xml mysqli-fetch-assoc.xml mysqli-fetch-field-direct.xml mysqli-fetch-field.xml
mysqli-fetch-fields.xml mysqli-fetch-lengths.xml mysqli-fetch-object.xml mysqli-fetch-row.xml mysqli-fetch.xml mysqli-field-count.xml
mysqli-field-seek.xml mysqli-field-tell.xml mysqli-free-result.xml

yannick Fri Feb 2 13:04:49 2007 UTC Modified files: /phpdoc-fr/reference/mysqli/functions mysqli-fetch-array.xml mysqli-fetch-assoc.xml mysqli-fetch-field-direct.xml mysqli-fetch-fields.xml mysqli-fetch-field.xml mysqli-fetch-lengths.xml mysqli-fetch-object.xml mysqli-fetch-row.xml mysqli-fetch.xml mysqli-field-count.xml mysqli-field-seek.xml mysqli-field-tell.xml mysqli-free-result.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-fetch-array.xml?r1=1.23&r2=1.24&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-fetch-array.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-fetch-array.xml:1.23 phpdoc-fr/reference/mysqli/functions/mysqli-fetch-array.xml:1.24 --- phpdoc-fr/reference/mysqli/functions/mysqli-fetch-array.xml:1.23 Tue Jan 17 01:58:25 2006 +++ phpdoc-fr/reference/mysqli/functions/mysqli-fetch-array.xml Fri Feb 2 13:04:49 2007 @@ -1,101 +1,118 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.23 $ --> -<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.24 $ --> +<!-- EN-Revision: 1.22 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-fetch-array"> - <refnamediv> - <refname>mysqli_fetch_array</refname> - <refname>result->fetch_array</refname> - <refpurpose> - Retourne une ligne de résultat sous la forme d'un - tableau associatif, d'un tableau indexé, ou les deux - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>mixed</type><methodname>mysqli_fetch_array</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> - </methodsynopsis> - &title.oop; - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>mixed</type><methodname>fetch_array</methodname> - <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - Retourne un tableau qui correspond à la ligne récupérée ou &null; s'il n'y a - plus de ligne dans le jeu de résultats <parameter>result</parameter>. - </para> - <para> - <function>mysqli_fetch_array</function> est une version étendue de la fonction - <function>mysqli_fetch_row</function>. En plus d'enregistrer les données - sous forme d'un tableau à indices numériques, elle peut aussi les - enregistrer dans un tableau associatif, en utilisant les noms des champs - comme clés. - </para> - &database.field-case; - &database.fetch-null; - <para> - Si plusieurs colonnes portent le même nom, la dernière colonne aura la - priorité. Pour accéder aux autres colonnes du même nom, vous devez - utiliser l'index numérique, ou faire un alias pour chaque colonne. - </para> - <para> - Le second argument optionnel <parameter>resulttype</parameter> est une - constante indiquant quel type de tableau doit être renvoyé à - partir de la ligne de données courante. Les valeurs possibles pour ce - paramètre sont les constantes MYSQLI_ASSOC, MYSQLI_NUM, et MYSQLI_BOTH. - MYSQLI_BOTH est la valeur par défaut de ce paramètre. - </para> - <para> - En utilisant la constante MYSQLI_ASSOC, cette fonction se comportera comme - la fonction <function>mysqli_fetch_assoc</function>, tandis que MYSQLI_NUM - la fera agir comme la fonction <function>mysqli_fetch_row</function>. - La constante MYSQLI_BOTH, créera elle un tableau qui sera à la fois - associatif et indexé numériquement. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Retourne un tableau qui correspond à la ligne récupérée ou &null; s'il - n'y a plus de ligne disponible dans le jeu de résultats. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Style orienté objet</title> - <programlisting role="php"> + +<refentry id="function.mysqli-fetch-array"> + <refnamediv> + <refname>mysqli_fetch_array</refname> + <refname>result->fetch_array()</refname> + <refpurpose>Retourne une ligne de résultat sous la forme d'un tableau associatif, d'un tableau indexé, ou les deux</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>mixed</type><methodname>mysqli_fetch_array</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>mixed</type><methodname>fetch_array</methodname> + <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Retourne un tableau qui correspond à la ligne récupérée ou &null; s'il n'y a + plus de ligne dans le jeu de résultats <parameter>result</parameter>. + </para> + <para> + <function>mysqli_fetch_array</function> est une version étendue de la fonction + <function>mysqli_fetch_row</function>. En plus d'enregistrer les données + sous forme d'un tableau à indices numériques, elle peut aussi les + enregistrer dans un tableau associatif, en utilisant les noms des champs + comme clés. + </para> + &database.field-case; + &database.fetch-null; + <para> + Si plusieurs colonnes portent le même nom, la dernière colonne aura la + priorité. Pour accéder aux autres colonnes du même nom, vous devez + utiliser l'index numérique, ou faire un alias pour chaque colonne. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + <varlistentry> + <term><parameter>resulttype</parameter></term> + <listitem> + <para> + Le second argument optionnel est une constante indiquant quel + type de tableau doit être renvoyé à partir de la ligne de données + courante. Les valeurs possibles pour ce paramètre sont les constantes + <constant>MYSQLI_ASSOC</constant>, <constant>MYSQLI_NUM</constant>, + et <constant>MYSQLI_BOTH</constant>. <constant>MYSQLI_BOTH</constant> + est la valeur par défaut de ce paramètre. + </para> + <para> + En utilisant la constante <constant>MYSQLI_ASSOC</constant>, cette fonction + se comportera comme la fonction <function>mysqli_fetch_assoc</function>, + tandis que <constant>MYSQLI_NUM</constant> la fera agir comme la fonction + <function>mysqli_fetch_row</function>. La constante + <constant>MYSQLI_BOTH</constant>, créera elle un tableau qui sera à la fois + associatif et indexé numériquement. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau qui correspond à la ligne récupérée ou &null; s'il + n'y a plus de ligne disponible dans le jeu de résultats. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Style orienté objet</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } - + $query = "SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"; $result = $mysqli->query($query); /* Tableau indexé numériquement */ $row = $result->fetch_array(MYSQLI_NUM); -printf ("%s (%s)\n", $row[0], $row[1]); +printf ("%s (%s)\n", $row[0], $row[1]); /* Tableau associatif */ $row = $result->fetch_array(MYSQLI_ASSOC); -printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); +printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); /* Tableau associatif et indexé numériquement */ $row = $result->fetch_array(MYSQLI_BOTH); -printf ("%s (%s)\n", $row[0], $row["CountryCode"]); +printf ("%s (%s)\n", $row[0], $row["CountryCode"]); /* Libération des résultats */ $result->close(); @@ -104,18 +121,18 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Style procédural</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Style procédural</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -124,15 +141,15 @@ /* Tableau indexé numériquement */ $row = mysqli_fetch_array($result, MYSQLI_NUM); -printf ("%s (%s)\n", $row[0], $row[1]); +printf ("%s (%s)\n", $row[0], $row[1]); /* Tableau associatif */ $row = mysqli_fetch_array($result, MYSQLI_ASSOC); -printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); +printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); /* Tableau associatif et indexé numériquement */ $row = mysqli_fetch_array($result, MYSQLI_BOTH); -printf ("%s (%s)\n", $row[0], $row["CountryCode"]); +printf ("%s (%s)\n", $row[0], $row["CountryCode"]); /* Libération des résultats */ mysqli_free_result($result); @@ -141,28 +158,32 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Kabul (AFG) Qandahar (AFG) Herat (AFG) ]]> - </screen> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_assoc</function>, - <function>mysqli_fetch_row</function>, - <function>mysqli_fetch_object</function>, - <function>mysqli_query</function> et - <function>mysqli_data_seek</function>. - </para> - </refsect1> - </refentry> + </screen> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_fetch_assoc</function></member> + <member><function>mysqli_fetch_row</function></member> + <member><function>mysqli_fetch_object</function></member> + <member><function>mysqli_query</function></member> + <member><function>mysqli_data_seek</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -183,4 +204,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-fetch-assoc.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-fetch-assoc.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-fetch-assoc.xml:1.21 phpdoc-fr/reference/mysqli/functions/mysqli-fetch-assoc.xml:1.22 --- phpdoc-fr/reference/mysqli/functions/mysqli-fetch-assoc.xml:1.21 Tue Jan 17 02:08:09 2006 +++ phpdoc-fr/reference/mysqli/functions/mysqli-fetch-assoc.xml Fri Feb 2 13:04:49 2007 @@ -1,82 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> -<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.22 $ --> +<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-fetch-assoc"> - <refnamediv> - <refname>mysqli_fetch_assoc</refname> - <refname>mysqli->fetch_assoc</refname> - <refpurpose> - Récupère une ligne de résultat sous forme de tableau associatif - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>array</type><methodname>mysqli_fetch_assoc</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - &title.oop; - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>array</type><methodname>fetch_assoc</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - Retourne un tableau associatif qui correspond à la ligne - récupérée ou &null; s'il n'y a plus de ligne. - </para> - <para> - La fonction <function>mysqli_fetch_assoc</function> est utilisée - pour retourner un tableau associatif représentant la prochaine - ligne dans le jeu de résultats représenté par le - paramètre <parameter>result</parameter>, où chaque clé - du tableau représente le nom d'une colonne du résultat. - </para> - <para> - Si deux ou plus colonnes dans le jeu de résultat ont le même - nom, le tableau associatif retrourné par la fonction - <function>mysqli_fetch_assoc</function> ne contiendra que la valeur de la - dernière colonne de ce nom. Si vous devez travailler avec des jeux - de résultats ayant cette particularité, la fonction - <function>mysqli_fetch_row</function> qui retourne un tableau indexé - doit être utilisée à la place. - </para> - &database.field-case; - &database.fetch-null; - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Retourne un tableau qui correspond à la ligne sélectionnée ou &null; s'il - n'y a plus de ligne dans le jeu de résultats. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Style orienté objet</title> - <programlisting role="php"> + +<refentry id="function.mysqli-fetch-assoc"> + <refnamediv> + <refname>mysqli_fetch_assoc</refname> + <refname>mysqli->fetch_assoc()</refname> + <refpurpose>Récupère une ligne de résultat sous forme de tableau associatif</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>array</type><methodname>mysqli_fetch_assoc</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>array</type><methodname>fetch_assoc</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Retourne un tableau associatif qui correspond à la ligne + récupérée ou &null; s'il n'y a plus de ligne. + </para> + &database.field-case; + &database.fetch-null; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif représentant la prochaine + ligne dans le jeu de résultats représenté par le paramètre + <parameter>result</parameter>, où chaque clé du + tableau représente le nom d'une colonne du résultat ou + &null; s'il n'y a plus de ligne dans le jeu de résultats. + </para> + <para> + Si deux ou plus colonnes dans le jeu de résultat ont le même + nom, le tableau associatif retrourné par la fonction + <function>mysqli_fetch_assoc</function> ne contiendra que + la valeur de la dernière colonne de ce nom. Si vous devez travailler + avec des jeux de résultats ayant cette particularité, la fonction + <function>mysqli_fetch_row</function> qui retourne un tableau indexé + doit être utilisée à la place. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Style orienté objet</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } - -$query = "SELECT Nom, CodePays FROM Ville ORDER by ID DESC LIMIT 50,5"; + +$query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5"; if ($result = $mysqli->query($query)) { /* Tableau associatif de la ligne sélectionnée */ while ($row = $result->fetch_assoc()) { - printf ("%s (%s)\n", $row["Nom"], $row["CodePays"]); + printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); } /* Libération du jeu de résultats */ @@ -87,28 +94,28 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Style procédural</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Style procédural</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } -$query = "SELECT Nom, CodePays FROM Ville ORDER by ID DESC LIMIT 50,5"; +$query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5"; if ($result = mysqli_query($link, $query)) { /* Tableau associatif de la ligne sélectionnée */ while ($row = mysqli_fetch_assoc($result)) { - printf ("%s (%s)\n", $row["Nom"], $row["CodePays"]); + printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); } /* Libération du jeu de résultats */ @@ -119,30 +126,34 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ -Rennes (FRA) -Bordeaux (FRA) -Rouen (FRA) -Paris (FRA) -Saint-Savin (FRA) +Pueblo (USA) +Arvada (USA) +Cape Coral (USA) +Green Bay (USA) +Santa Clara (USA) ]]> - </screen> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_array</function>, - <function>mysqli_fetch_row</function>, - <function>mysqli_fetch_object</function>, - <function>mysqli_query</function> et - <function>mysqli_data_seek</function>. - </para> - </refsect1> - </refentry> + </screen> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_fetch_array</function></member> + <member><function>mysqli_fetch_row</function></member> + <member><function>mysqli_fetch_object</function></member> + <member><function>mysqli_query</function></member> + <member><function>mysqli_data_seek</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -163,4 +174,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field-direct.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field-direct.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field-direct.xml:1.16 phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field-direct.xml:1.17 --- phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field-direct.xml:1.16 Thu Mar 2 13:42:22 2006 +++ phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field-direct.xml Fri Feb 2 13:04:49 2007 @@ -1,116 +1,135 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-fetch-field-direct"> - <refnamediv> - <refname>mysqli_fetch_field_direct</refname> - <refname>result->fetch_field_direct</refname> - <refpurpose> - Récupère les données métas d'un champ unique - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>object</type><methodname>mysqli_fetch_field_direct</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> - </methodsynopsis> - &title.oop; - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>object</type><methodname>fetch_field_direct</methodname> - <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_fetch_field_direct</function> retourne un objet qui contient les données métas - d'un champ depuis le jeu de résultats <parameter>result</parameter>. - Les valeurs de <parameter>fieldnr</parameter> doivent être dans l'intervalle - &zero; à <literal>nombre de champs - 1</literal>. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Retourne un objet qui contient les données métas d'un champ ou &false; si aucune donnée méta - n'est spécifiée pour le champ <parameter>fieldnr</parameter>. - </para> - <para> - <table> - <title>Attributs de l'objet</title> - <tgroup cols='2'> - <thead> - <row> - <entry>Attribut</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>name</entry> - <entry>Le nom de la colonne</entry> - </row> - <row> - <entry>orgname</entry> - <entry>Le nom original de la colonne si un alias a été spécifié</entry> - </row> - <row> - <entry>table</entry> - <entry>Le nom de la table à laquelle ce champ appartient (s'il n'a pas été calculé)</entry> - </row> - <row> - <entry>orgtable</entry> - <entry>Le nom original de la table si un alias a été spécifié</entry> - </row> - <row> - <entry>def</entry> - <entry>La valeur par défaut du champ, représentée par une chaîne de caractères</entry> - </row> - <row> - <entry>max_length</entry> - <entry>La longueur maximale du champ pour le jeu de résultats</entry> - </row> - <row> - <entry>length</entry> - <entry>La largeur du champ, comme spécifiée dans la définition de table.</entry> - </row> - <row> - <entry>charsetnr</entry> - <entry>Le numéro du jeu de caractères pour ce champ.</entry> - </row> - <row> - <entry>flags</entry> - <entry>Un entier représentant le bit-flags pour ce champ</entry> - </row> - <row> - <entry>type</entry> - <entry>Le type de données utilisées pour ce champ</entry> - </row> - <row> - <entry>decimals</entry> - <entry>Le nombre de décimales utilisées (pour les champs de type entier)</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Style orienté objet</title> - <programlisting role="php"> + +<refentry id="function.mysqli-fetch-field-direct"> + <refnamediv> + <refname>mysqli_fetch_field_direct</refname> + <refname>result->fetch_field_direct()</refname> + <refpurpose>Récupère les données métas d'un champ unique</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>object</type><methodname>mysqli_fetch_field_direct</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>object</type><methodname>fetch_field_direct</methodname> + <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Retourne un objet qui contient les données métas + d'un champ depuis le jeu de résultats spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + <varlistentry> + <term><parameter>fieldnr</parameter></term> + <listitem> + <para> + Le numéro du champs. Cette valeur doit être dans l'intervalle + <literal>0</literal> à <literal>nombre de champs - 1</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un objet qui contient les données métas d'un champ + ou &false; si aucune donnée méta n'est spécifiée pour le champ + <parameter>fieldnr</parameter>. + </para> + <para> + <table> + <title>Attributs de l'objet</title> + <tgroup cols='2'> + <thead> + <row> + <entry>Attribut</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry>Le nom de la colonne</entry> + </row> + <row> + <entry>orgname</entry> + <entry>Le nom original de la colonne si un alias a été spécifié</entry> + </row> + <row> + <entry>table</entry> + <entry>Le nom de la table à laquelle ce champs appartient (s'il n'a pas été calculé)</entry> + </row> + <row> + <entry>orgtable</entry> + <entry>Le nom original de la table si un alias a été spécifié</entry> + </row> + <row> + <entry>def</entry> + <entry>La valeur par défaut du champs, représentée par une chaîne de caractères</entry> + </row> + <row> + <entry>max_length</entry> + <entry>La longueur maximale du champs pour le jeu de résultats</entry> + </row> + <row> + <entry>length</entry> + <entry>La largeur du champs, comme spécifiée dans la définition de table</entry> + </row> + <row> + <entry>charsetnr</entry> + <entry>Le numéro du jeu de caractères pour ce champs</entry> + </row> + <row> + <entry>flags</entry> + <entry>Un entier représentant le bit-flags pour ce champs</entry> + </row> + <row> + <entry>type</entry> + <entry>Le type de données utilisées pour ce champs</entry> + </row> + <row> + <entry>decimals</entry> + <entry>Le nombre de décimales utilisées (pour les champs de type entier)</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Style orienté objet</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -120,13 +139,13 @@ /* Récupération des données métas pour la colonne 'SurfaceArea' */ $finfo = $result->fetch_field_direct(1); - + printf("Nom : %s\n", $finfo->name); printf("Table : %s\n", $finfo->table); printf("Longueur Max. : %d\n", $finfo->max_length); printf("Flags : %d\n", $finfo->flags); printf("Type : %d\n", $finfo->type); - + $result->close(); } @@ -134,18 +153,18 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Style procédural</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Style procédural</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -169,10 +188,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Nom : SurfaceArea Table : Country @@ -180,17 +199,21 @@ Flags : 32769 Type : 4 ]]> - </screen> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_num_fields</function>, - <function>mysqli_fetch_field</function> et - <function>mysqli_fetch_fields</function>. - </para> - </refsect1> - </refentry> + </screen> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_num_fields</function></member> + <member><function>mysqli_fetch_field</function></member> + <member><function>mysqli_fetch_fields</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -211,4 +234,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-fetch-fields.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-fetch-fields.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-fetch-fields.xml:1.18 phpdoc-fr/reference/mysqli/functions/mysqli-fetch-fields.xml:1.19 --- phpdoc-fr/reference/mysqli/functions/mysqli-fetch-fields.xml:1.18 Thu Mar 2 13:42:22 2006 +++ phpdoc-fr/reference/mysqli/functions/mysqli-fetch-fields.xml Fri Feb 2 13:04:49 2007 @@ -1,114 +1,126 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.21 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-fetch-fields"> - <refnamediv> - <refname>mysqli_fetch_fields</refname> - <refname>result->fetch_fields</refname> - <refpurpose> - Retourne un tableau d'objets représentant les champs dans le résultat - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>array</type><methodname>mysqli_fetch_fields</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - &title.oop; - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>array</type><methodname>fetch_fields</methodname> - <void/> - </methodsynopsis> - </classsynopsis> - <para> - Cette fonction fonctionne comme <function>mysqli_fetch_field</function> - à la différence que, au lieu de retourner un objet à la fois - pour chaque champ, les colonnes sont retournées en tant que tableau d'objets. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Retourne un tableau d'objets qui contient les données métas d'un champ ou &false; - si aucune donnée méta n'est disponible pour ce champ. - </para> - <para> - <table> - <title>Propriétés de l'objet</title> - <tgroup cols='2'> - <thead> - <row> - <entry>Propriété</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>name</entry> - <entry>Le nom de la colonne</entry> - </row> - <row> - <entry>orgname</entry> - <entry>Le nom original de la colonne si un alias a été spécifié</entry> - </row> - <row> - <entry>table</entry> - <entry>Le nom de la table à laquelle ce champ appartient (s'il n'a pas été calculé)</entry> - </row> - <row> - <entry>orgtable</entry> - <entry>Le nom original de la table si un alias a été spécifié</entry> - </row> - <row> - <entry>def</entry> - <entry>La valeur par défaut du champ, représentée par une chaîne de caractères</entry> - </row> - <row> - <entry>max_length</entry> - <entry>La longueur maximale du champ pour le jeu de résultats</entry> - </row> - <row> - <entry>length</entry> - <entry>La largeur du champ, comme spécifiée dans la définition de table.</entry> - </row> - <row> - <entry>charsetnr</entry> - <entry>Le numéro du jeu de caractères pour ce champ.</entry> - </row> - <row> - <entry>flags</entry> - <entry>Un entier représentant le bit-flags pour ce champ</entry> - </row> - <row> - <entry>type</entry> - <entry>Le type de données utilisées pour ce champ</entry> - </row> - <row> - <entry>decimals</entry> - <entry>Le nombre de décimales utilisées (pour les champs de type entier)</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Style orienté objet</title> - <programlisting role="php"> + +<refentry id="function.mysqli-fetch-fields"> + <refnamediv> + <refname>mysqli_fetch_fields</refname> + <refname>result->fetch_fields()</refname> + <refpurpose>Retourne un tableau d'objets représentant les champs dans le résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>array</type><methodname>mysqli_fetch_fields</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>array</type><methodname>fetch_fields</methodname> + <void/> + </methodsynopsis> + </classsynopsis> + <para> + Cette fonction fonctionne comme <function>mysqli_fetch_field</function> + à la différence que, au lieu de retourner un objet à la fois + pour chaque champ, les colonnes sont retournées en tant + que tableau d'objets. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau d'objets qui contient les données métas d'un champ ou &false; + si aucune donnée méta n'est disponible pour ce champ. + </para> + <para> + <table> + <title>Propriétés de l'objet</title> + <tgroup cols='2'> + <thead> + <row> + <entry>Propriété</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry>Le nom de la colonne</entry> + </row> + <row> + <entry>orgname</entry> + <entry>Le nom original de la colonne si un alias a été spécifié</entry> + </row> + <row> + <entry>table</entry> + <entry>Le nom de la table à laquelle ce champ appartient (s'il n'a pas été calculé)</entry> + </row> + <row> + <entry>orgtable</entry> + <entry>Le nom original de la table si un alias a été spécifié</entry> + </row> + <row> + <entry>def</entry> + <entry>La valeur par défaut du champs, représentée par une chaîne de caractères</entry> + </row> + <row> + <entry>max_length</entry> + <entry>La longueur maximale du champs pour le jeu de résultats</entry> + </row> + <row> + <entry>length</entry> + <entry>La largeur du champs, comme spécifiée dans la définition de table</entry> + </row> + <row> + <entry>charsetnr</entry> + <entry>Le numéro du jeu de caractères pour ce champs</entry> + </row> + <row> + <entry>flags</entry> + <entry>Un entier représentant le bit-flags pour ce champs</entry> + </row> + <row> + <entry>type</entry> + <entry>Le type de données utilisées pour ce champs</entry> + </row> + <row> + <entry>decimals</entry> + <entry>Le nombre de décimales utilisées (pour les champs de type entier)</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Style orienté objet</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -120,11 +132,11 @@ $finfo = $result->fetch_fields(); foreach ($finfo as $val) { - printf("Nom : %s\n", $finfo[$i]->name); - printf("Table : %s\n", $finfo[$i]->table); - printf("Longueur Max. : %d\n", $finfo[$i]->max_length); - printf("Flags : %d\n", $finfo[$i]->flags); - printf("Type : %d\n\n", $finfo[$i]->type); + printf("Nom : %s\n", $val->name); + printf("Table : %s\n", $val->table); + printf("Longueur Max. : %d\n", $val->max_length); + printf("Flags : %d\n", $val->flags); + printf("Type : %d\n\n", $val->type); } $result->close(); } @@ -133,18 +145,18 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Style procédural</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Style procédural</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion: %s\n", mysqli_connect_error()); exit(); } @@ -156,11 +168,11 @@ $finfo = mysqli_fetch_fields($result); foreach ($finfo as $val) { - printf("Nom : %s\n", $finfo[$i]->name); - printf("Table : %s\n", $finfo[$i]->table); - printf("Longueur Max. : %d\n", $finfo[$i]->max_length); - printf("Flags : %d\n", $finfo[$i]->flags); - printf("Type : %d\n\n", $finfo[$i]->type); + printf("Nom : %s\n", $val->name); + printf("Table : %s\n", $val->table); + printf("Longueur Max. : %d\n", $val->max_length); + printf("Flags : %d\n", $val->flags); + printf("Type : %d\n\n", $val->type); } mysqli_free_result($result); } @@ -169,13 +181,13 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Nom : Name -Table : Country +Table : Country Longueur Max. : 11 Flags : 1 Type : 254 @@ -187,17 +199,21 @@ Type : 4 ]]> - </screen> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_num_fields</function>, - <function>mysqli_fetch_field</function> et - <function>mysqli_fetch_field_direct</function>. - </para> - </refsect1> - </refentry> + </screen> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_num_fields</function></member> + <member><function>mysqli_fetch_field_direct</function></member> + <member><function>mysqli_fetch_field</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -218,4 +234,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field.xml:1.17 phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field.xml:1.18 --- phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field.xml:1.17 Thu Mar 2 13:42:22 2006 +++ phpdoc-fr/reference/mysqli/functions/mysqli-fetch-field.xml Fri Feb 2 13:04:49 2007 @@ -1,117 +1,126 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.19 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.21 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-fetch-field"> - <refnamediv> - <refname>mysqli_fetch_field</refname> - <refname>result->fetch_field</refname> - <refpurpose>Retourne le prochain champ dans le jeu de résultats</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>object</type><methodname>mysqli_fetch_field</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - &title.oop; - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>object</type><methodname>fetch_field</methodname> - <void/> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_fetch_field</function> est utilisée - pour retourner les attributs de la prochaine colonne dans le jeu de - résultats représenté par le paramètre - <parameter>result</parameter> en tant qu'objet. - Appelez cette fonction de façon répétitive pour récupérer les informations de toutes les colonnes. - Lors de son exécution, cette fonction retournera un objet contenant - les attributs de la colonne courante ou &false; s'il n'y a plus de colonnes - dans le jeu de résultats. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Retourne un objet qui contient les informations d'un champ ou &false; si aucune information - n'est disponible pour ce champ. - </para> - <para> - <table> - <title>Propriétés de l'objet</title> - <tgroup cols='2'> - <thead> - <row> - <entry>Propriété</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>name</entry> - <entry>Le nom de la colonne</entry> - </row> - <row> - <entry>orgname</entry> - <entry>Le nom original de la colonne si un alias a été spécifié</entry> - </row> - <row> - <entry>table</entry> - <entry>Le nom de la table à laquelle ce champ appartient (s'il n'a pas été calculé)</entry> - </row> - <row> - <entry>orgtable</entry> - <entry>Le nom original de la table si un alias a été spécifié</entry> - </row> - <row> - <entry>def</entry> - <entry>La valeur par défaut du champ, représentée par une chaîne de caractères</entry> - </row> - <row> - <entry>max_length</entry> - <entry>La longueur maximale du champ pour le jeu de résultats</entry> - </row> - <row> - <entry>length</entry> - <entry>La largeur du champ, comme spécifiée dans la définition de table.</entry> - </row> - <row> - <entry>charsetnr</entry> - <entry>Le numéro du jeu de caractères pour ce champ.</entry> - </row> - <row> - <entry>flags</entry> - <entry>Un entier représentant le bit-flags pour ce champ</entry> - </row> - <row> - <entry>type</entry> - <entry>Le type de données utilisées pour ce champ</entry> - </row> - <row> - <entry>decimals</entry> - <entry>Le nombre de décimales utilisées (pour les champs de type entier)</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Style orienté objet</title> - <programlisting role="php"> + +<refentry id="function.mysqli-fetch-field"> + <refnamediv> + <refname>mysqli_fetch_field</refname> + <refname>result->fetch_field()</refname> + <refpurpose>Retourne le prochain champs dans le jeu de résultats</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>object</type><methodname>mysqli_fetch_field</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>object</type><methodname>fetch_field</methodname> + <void/> + </methodsynopsis> + </classsynopsis> + <para> + Retourne les attributs de la prochaine colonne dans le jeu de + résultats représenté par le paramètre <parameter>result</parameter> + en tant qu'objet. Appelez cette fonction de façon répétitive pour + récupérer les informations de toutes les colonnes. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un objet qui contient les informations d'un champ ou &false; + si aucune information n'est disponible pour ce champs. + </para> + <para> + <table> + <title>Propriétés de l'objet</title> + <tgroup cols='2'> + <thead> + <row> + <entry>Propriété</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry>Le nom de la colonne</entry> + </row> + <row> + <entry>orgname</entry> + <entry>Le nom original de la colonne si un alias a été spécifié</entry> + </row> + <row> + <entry>table</entry> + <entry>Le nom de la table à laquelle ce champs appartient (s'il n'a pas été calculé)</entry> + </row> + <row> + <entry>orgtable</entry> + <entry>Le nom original de la table si un alias a été spécifié</entry> + </row> + <row> + <entry>def</entry> + <entry>La valeur par défaut du champs, représentée par une chaîne de caractères</entry> + </row> + <row> + <entry>max_length</entry> + <entry>La longueur maximale du champs pour le jeu de résultats</entry> + </row> + <row> + <entry>length</entry> + <entry>La largeur du champs, comme spécifiée dans la définition de table</entry> + </row> + <row> + <entry>charsetnr</entry> + <entry>Le numéro du jeu de caractères pour ce champs</entry> + </row> + <row> + <entry>flags</entry> + <entry>Un entier représentant le bit-flags pour ce champs</entry> + </row> + <row> + <entry>type</entry> + <entry>Le type de données utilisées pour ce champs</entry> + </row> + <row> + <entry>decimals</entry> + <entry>Le nombre de décimales utilisées (pour les champs de type entier)</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Style orienté objet</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -135,18 +144,18 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Style procédural</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Style procédural</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -170,10 +179,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Nom : Name Table : Country @@ -188,18 +197,22 @@ Type : 4 ]]> - </screen> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_num_fields</function>, - <function>mysqli_fetch_field_direct</function>, - <function>mysqli_fetch_fields</function> et - <function>mysqli_field_seek</function>. - </para> - </refsect1> - </refentry> + </screen> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_num_fields</function></member> + <member><function>mysqli_fetch_field_direct</function></member> + <member><function>mysqli_fetch_fields</function></member> + <member><function>mysqli_field_seek</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -220,4 +233,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-fetch-lengths.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-fetch-lengths.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-fetch-lengths.xml:1.15 phpdoc-fr/reference/mysqli/functions/mysqli-fetch-lengths.xml:1.16 --- phpdoc-fr/reference/mysqli/functions/mysqli-fetch-lengths.xml:1.15 Sun Jul 3 13:07:46 2005 +++ phpdoc-fr/reference/mysqli/functions/mysqli-fetch-lengths.xml Fri Feb 2 13:04:49 2007 @@ -1,61 +1,68 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.19 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-fetch-lengths"> - <refnamediv> - <refname>mysqli_fetch_lengths</refname> - <refname>result->lengths</refname> - <refpurpose> - Retourne la longueur des colonnes de la ligne courante du jeu de résultats - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>array</type><methodname>mysqli_fetch_lengths</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - &title.oop; - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <fieldsynopsis><type>array</type><varname>lengths</varname></fieldsynopsis> - </classsynopsis> - <para> - La fonction <function>mysqli_fetch_lengths</function> retourne un tableau - contenant la longueur de chaque colonne de la ligne courante du jeu de - résultats représenté par le paramètre - <parameter>result</parameter>. - Un tableau indexé numériquement représentant la longueur - de chaque colonne est retourné en cas de succès, &false; en cas - d'échec. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Un tableau d'entiers représentant la taille de chaque colonne (n'incluant aucun caractère null de fin). - Retourne &false; si une erreur survient. - </para> - <para> - <function>mysqli_fetch_lengths</function> n'est valide que pour la ligne courant du - jeu de résultats. Elle retourne &false; si vous l'appelez avant les fonctions - mysqli_fetch_row/array/object ou après avoir récupéré toutes les lignes du résultat. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Style orienté objet</title> - <programlisting role="php"> + +<refentry id="function.mysqli-fetch-lengths"> + <refnamediv> + <refname>mysqli_fetch_lengths</refname> + <refname>result->lengths()</refname> + <refpurpose>Retourne la longueur des colonnes de la ligne courante du jeu de résultats</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>array</type><methodname>mysqli_fetch_lengths</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <fieldsynopsis><type>array</type><varname>lengths</varname></fieldsynopsis> + </classsynopsis> + <para> + La fonction <function>mysqli_fetch_lengths</function> retourne un tableau + contenant la longueur de chaque colonne de la ligne courante du jeu de + résultats représenté par le paramètre <parameter>result</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Un tableau d'entiers représentant la taille de chaque colonne (n'incluant aucun caractère null de fin). + Retourne &false; si une erreur survient. + </para> + <para> + <function>mysqli_fetch_lengths</function> n'est valide que pour la ligne courant du + jeu de résultats. Elle retourne &false; si vous l'appelez avant les fonctions + mysqli_fetch_row/array/object ou après avoir récupéré toutes les lignes du résultat. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Style orienté objet</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -65,9 +72,9 @@ $row = $result->fetch_row(); - /* Affiche la longueur des colonnes */ + /* ffiche la longueur des colonnes */ foreach ($result->lengths as $i => $val) { - printf("Le champ %2d a une longueur de %2d\n", $i+1, $val); + printf("Le champ %2d a une longueur de %2d\n", $i+1, $val); } $result->close(); } @@ -76,18 +83,18 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Style procédural</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Style procédural</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -98,9 +105,8 @@ $row = mysqli_fetch_row($result); /* Affiche la longueur des colonnes */ - $lengths = mysqli_fetch_lengths($result); foreach (mysqli_fetch_lengths($result) as $i => $val) { - printf("Le champ %2d a un longueur de %2d\n", $i+1, $val); + printf("Le champ %2d a un longueur de %2d\n", $i+1, $val); } mysqli_free_result($result); } @@ -109,10 +115,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Le champ 1 a un longueur de 3 Le champ 2 a un longueur de 5 @@ -130,9 +136,10 @@ Le champ 14 a un longueur de 3 Le champ 15 a un longueur de 2 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -153,4 +160,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-fetch-object.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-fetch-object.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-fetch-object.xml:1.18 phpdoc-fr/reference/mysqli/functions/mysqli-fetch-object.xml:1.19 --- phpdoc-fr/reference/mysqli/functions/mysqli-fetch-object.xml:1.18 Sun Sep 3 09:47:04 2006 +++ phpdoc-fr/reference/mysqli/functions/mysqli-fetch-object.xml Fri Feb 2 13:04:49 2007 @@ -1,17 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.19 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.mysqli-fetch-object"> <refnamediv> <refname>mysqli_fetch_object</refname> - <refname>result->fetch_object</refname> - <refpurpose> - Retourne la ligne courante d'un jeu de résultat sous forme d'objet - </refpurpose> + <refname>result->fetch_object()</refname> + <refpurpose>Retourne la ligne courante d'un jeu de résultat sous forme d'objet</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; &title.procedural; <methodsynopsis> @@ -32,12 +31,35 @@ <para> La fonction <function>mysqli_fetch_object</function> retourne la ligne courante du jeu de résultat sous forme d'objet dont les attributs - représentent les noms des champs trouvés dans le jeu de - résultats. S'il n'y a plus de ligne à lire, la fonction retourne &null;. + représentent les noms des champs trouvés dans le jeu de + résultats. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>params</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> </para> </refsect1> - <refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne un objet qui correspond à la ligne récupérée ou &null; s'il @@ -71,7 +93,7 @@ </para> </refsect1> - <refsect1> + <refsect1 role="examples"> &reftitle.examples; <example> <title>Style orienté objet</title> @@ -82,21 +104,21 @@ /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); - exit(); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); + exit(); } $query = "SELECT Nom, CodePays FROM Ville ORDER by ID DESC LIMIT 50,5"; if ($result = $mysqli->query($query)) { - /* Récupération du tableau d'objet */ - while ($obj = $result->fetch_object()) { - printf ("%s (%s)\n", $obj->Nom, $obj->CodePays); - } + /* Récupération du tableau d'objet */ + while ($obj = $result->fetch_object()) { + printf ("%s (%s)\n", $obj->Nom, $obj->CodePays); + } - /* Libération du jeu de résultats */ - $result->close(); + /* Libération du jeu de résultats */ + $result->close(); } /* Fermeture de la connexion */ @@ -114,21 +136,21 @@ /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); - exit(); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); + exit(); } $query = "SELECT Nom, CodePays FROM Ville ORDER by ID DESC LIMIT 50,5"; if ($result = mysqli_query($link, $query)) { - /* Récupération du tableau d'objet */ - while ($obj = mysqli_fetch_object($result)) { - printf ("%s (%s)\n", $obj->Nom, $obj->CodePays); - } + /* Récupération du tableau d'objet */ + while ($obj = mysqli_fetch_object($result)) { + printf ("%s (%s)\n", $obj->Nom, $obj->CodePays); + } - /* Libération du jeu de résultats */ - mysqli_free_result($result); + /* Libération du jeu de résultats */ + mysqli_free_result($result); } /* Fermeture de la connexion */ @@ -149,16 +171,19 @@ </screen> </refsect1> - <refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> - <function>mysqli_fetch_array</function>, - <function>mysqli_fetch_assoc</function>, - <function>mysqli_fetch_row</function>, - <function>mysqli_query</function> et - <function>mysqli_data_seek</function>. + <simplelist> + <member><function>mysqli_fetch_array</function></member> + <member><function>mysqli_fetch_assoc</function></member> + <member><function>mysqli_fetch_row</function></member> + <member><function>mysqli_query</function></member> + <member><function>mysqli_data_seek</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-fetch-row.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-fetch-row.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-fetch-row.xml:1.17 phpdoc-fr/reference/mysqli/functions/mysqli-fetch-row.xml:1.18 --- phpdoc-fr/reference/mysqli/functions/mysqli-fetch-row.xml:1.17 Fri Dec 8 18:56:48 2006 +++ phpdoc-fr/reference/mysqli/functions/mysqli-fetch-row.xml Fri Feb 2 13:04:49 2007 @@ -1,68 +1,73 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-fetch-row"> - <refnamediv> - <refname>mysqli_fetch_row</refname> - <refname>result->fetch_row</refname> - <refpurpose> - Récupère une ligne de résultat sous forme de tableau indexé - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>mixed</type><methodname>mysqli_fetch_row</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - &title.oop; - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>mixed</type><methodname>fetch_row</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - Retourne un tableau correspondant à la ligne récupérée - ou &null; s'il n'y a plus de ligne. - </para> - <para> - <function>mysqli_fetch_row</function> récupère une ligne de données - à partir du jeu de résultats représenté par - <parameter>result</parameter> et le retourne en tant que tableau indexé, où - chaque colonne est une case du tableau, celui-ci commençant à 0 (zéro). - Chaque nouvel appel à <function>mysqli_fetch_row</function> retournera la - prochaine ligne dans le jeu de résultats, ou &null; s'il n'y a plus de - lignes. - </para> - &database.fetch-null; - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - <function>mysqli_fetch_row</function> retourne un tableau correspondant à la ligne - récupérée ou &null; s'il n'y a plus de ligne dans le jeu de résultats. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Style orienté objet</title> - <programlisting role="php"> +<refentry id="function.mysqli-fetch-row"> + <refnamediv> + <refname>mysqli_fetch_row</refname> + <refname>result->fetch_row()</refname> + <refpurpose>Récupère une ligne de résultat sous forme de tableau indexé</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>mixed</type><methodname>mysqli_fetch_row</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>mixed</type><methodname>fetch_row</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + récupère une ligne de données à partir du jeu de résultats représenté par + <parameter>result</parameter> et le retourne en tant que tableau indexé, où + chaque colonne est une case du tableau, celui-ci commençant à 0 (zéro). + Chaque nouvel appel à <function>mysqli_fetch_row</function> retournera la + prochaine ligne dans le jeu de résultats, ou &null; s'il n'y a plus de + lignes. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <function>mysqli_fetch_row</function> retourne un tableau correspondant à la ligne + récupérée ou &null; s'il n'y a plus de ligne dans le jeu de résultats. + </para> + &database.fetch-null; + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Style orienté objet</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } - + $query = "SELECT Nom, CodePays FROM Ville ORDER by ID DESC LIMIT 50,5"; if ($result = $mysqli->query($query)) { @@ -80,18 +85,18 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Style procédural</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Style procédural</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -112,10 +117,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Rennes (FRA) Rouen (FRA) @@ -123,19 +128,23 @@ Paris (FRA) Saint-Savin (FRA) ]]> - </screen> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_array</function>, - <function>mysqli_fetch_assoc</function>, - <function>mysqli_fetch_object</function>, - <function>mysqli_query</function> et - <function>mysqli_data_seek</function>. - </para> - </refsect1> - </refentry> + </screen> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_fetch_array</function></member> + <member><function>mysqli_fetch_assoc</function></member> + <member><function>mysqli_fetch_object</function></member> + <member><function>mysqli_query</function></member> + <member><function>mysqli_data_seek</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -156,4 +165,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-fetch.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-fetch.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-fetch.xml:1.11 phpdoc-fr/reference/mysqli/functions/mysqli-fetch.xml:1.12 --- phpdoc-fr/reference/mysqli/functions/mysqli-fetch.xml:1.11 Tue Nov 16 21:56:51 2004 +++ phpdoc-fr/reference/mysqli/functions/mysqli-fetch.xml Fri Feb 2 13:04:49 2007 @@ -1,34 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-fetch"> - <refnamediv> - <refname>mysqli_fetch</refname> - <refpurpose>Alias de <function>mysqli_stmt_fetch</function></refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <para> - <function>mysqli_fetch</function> &isalias; - <function>mysqli_stmt_fetch</function>. - Pour une description détaillée, voir la description de la fonction - <function>mysqli_stmt_fetch</function>. - </para> - <note> - <para> - <function>mysqli_fetch</function> est fortement déconseillée et devrait être - supprimée prochainement. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_fetch</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.mysqli-fetch"> + <refnamediv> + <refname>mysqli_fetch</refname> + <refpurpose>Alias de <function>mysqli_stmt_fetch</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <para> + <function>mysqli_fetch</function> &isalias; + <function>mysqli_stmt_fetch</function>. + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + <function>mysqli_fetch</function> est fortement déconseillée et devrait être + supprimée prochainement. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_stmt_fetch</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -49,4 +57,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-field-count.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-field-count.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-field-count.xml:1.15 phpdoc-fr/reference/mysqli/functions/mysqli-field-count.xml:1.16 --- phpdoc-fr/reference/mysqli/functions/mysqli-field-count.xml:1.15 Fri Dec 16 15:22:19 2005 +++ phpdoc-fr/reference/mysqli/functions/mysqli-field-count.xml Fri Feb 2 13:04:49 2007 @@ -1,15 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.mysqli-field-count"> <refnamediv> <refname>mysqli_field_count</refname> - <refname>mysqli->field_count</refname> + <refname>mysqli->field_count()</refname> <refpurpose>Retourne le nombre de colonnes pour la dernière requête</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; &title.procedural; <methodsynopsis> @@ -23,32 +24,45 @@ <type>int</type><methodname>field_count</methodname> <void /> </methodsynopsis> - </classsynopsis> + </classsynopsis> <para> Retourne le nombre de colonnes pour la dernière requête - sur la connexion spécifiée par le paramètre + sur la connexion spécifiée par le paramètre <parameter>link</parameter>. Cette fonction peut être utile lors de l'utilisation de <function>mysqli_store_result</function> pour déterminer si la requête aurait du retourner un résultat vide ou non, sans en connaître la nature. </para> </refsect1> - <refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.link.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> &reftitle.returnvalues; - <para>Un entier représentant le nombre de champs dans un jeu de résultats</para> + <para> + Un entier représentant le nombre de champs dans un jeu de résultats. + </para> </refsect1> - <refsect1> + + <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Style orienté objet</title> - <programlisting role="php"> + <programlisting role='php'> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "test"); -$mysqli->query( "DROP TABLE IF EXISTS friends"); -$mysqli->query( "CREATE TABLE friends (id int, name varchar(20))"); +$mysqli->query( "DROP TABLE IF EXISTS friends"); +$mysqli->query( "CREATE TABLE friends (id int, name varchar(20))"); $mysqli->query( "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); @@ -79,8 +93,8 @@ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "test"); -mysqli_query($link, "DROP TABLE IF EXISTS friends"); -mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))"); +mysqli_query($link, "DROP TABLE IF EXISTS friends"); +mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))"); mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); @@ -105,6 +119,7 @@ </example> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-field-seek.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-field-seek.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-field-seek.xml:1.13 phpdoc-fr/reference/mysqli/functions/mysqli-field-seek.xml:1.14 --- phpdoc-fr/reference/mysqli/functions/mysqli-field-seek.xml:1.13 Tue Jul 5 20:08:10 2005 +++ phpdoc-fr/reference/mysqli/functions/mysqli-field-seek.xml Fri Feb 2 13:04:49 2007 @@ -1,59 +1,81 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-field-seek"> - <refnamediv> - <refname>mysqli_field_seek</refname> - <refname>result->field_seek</refname> - <refpurpose> - Déplace le pointeur de résultat sur le champ spécifié - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>bool</type><methodname>mysqli_field_seek</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> - </methodsynopsis> - &title.oop; - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>field_seek</methodname> - <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_field_seek</function> place le curseur sur le champ spécifié par le numéro - <parameter>fieldnr</parameter>. Le prochain appel à la fonction - <function>mysqli_fetch_field</function> retournera la définition du champ de la colonne - associée à cette position. - </para> - <note> - <para>Pour se déplacer au début d'une ligne, passez une position ayant pour valeur zéro.</para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - <function>mysqli_field_seek</function> retourne la valeur précédente du curseur. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Style orienté objet</title> - <programlisting role="php"> + +<refentry id="function.mysqli-field-seek"> + <refnamediv> + <refname>mysqli_field_seek</refname> + <refname>result->field_seek()</refname> + <refpurpose>Déplace le pointeur de résultat sur le champs spécifié</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>bool</type><methodname>mysqli_field_seek</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>field_seek</methodname> + <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Place le curseur sur le champs spécifié par le numéro + <parameter>fieldnr</parameter>. Le prochain appel à la fonction + <function>mysqli_fetch_field</function> retournera la définition du + champ de la colonne associée à cette position. + </para> + <note> + <para> + Pour se déplacer au début d'une ligne, passez une position ayant pour valeur zéro. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + <varlistentry> + <term><parameter>fieldnr</parameter></term> + <listitem> + <para> + Le numéro du champs. Cette valeur doit être dans l'intervalle + <literal>0</literal> à <literal>nombre de champs - 1</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la valeur précédente du curseur. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Style orienté objet</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -78,18 +100,18 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Style procédural</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Style procédural</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -114,10 +136,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Nom : SurfaceArea Table : Country @@ -126,15 +148,19 @@ Type : 4 ]]> - </screen> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_field</function>. - </para> - </refsect1> - </refentry> + </screen> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_fetch_field</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -155,4 +181,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-field-tell.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-field-tell.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-field-tell.xml:1.11 phpdoc-fr/reference/mysqli/functions/mysqli-field-tell.xml:1.12 --- phpdoc-fr/reference/mysqli/functions/mysqli-field-tell.xml:1.11 Tue Jul 5 20:08:10 2005 +++ phpdoc-fr/reference/mysqli/functions/mysqli-field-tell.xml Fri Feb 2 13:04:49 2007 @@ -1,54 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-field-tell"> - <refnamediv> - <refname>mysqli_field_tell</refname> - <refname>result->current_field</refname> - <refpurpose> - Retourne la position du champ courant dans un pointeur de résultat - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>int</type><methodname>mysqli_field_tell</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - &title.oop; - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <fieldsynopsis> - <type>int</type><varname>current_field</varname> - </fieldsynopsis> - </classsynopsis> - <para> - <function>mysqli_field_tell</function> retourne la position du champ dans un pointeur utilisée - par le dernier appel à <function>mysqli_fetch_field</function>. - Cette valeur peut être utilisée comme argument à la fonction - <function>mysqli_field_seek</function>. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Retourne la position du champ courant dans le curseur. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Style orienté objet</title> - <programlisting role="php"> + +<refentry id="function.mysqli-field-tell"> + <refnamediv> + <refname>mysqli_field_tell</refname> + <refname>result->current_field</refname> + <refpurpose>Retourne la position du champs courant dans un pointeur de résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>int</type><methodname>mysqli_field_tell</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <fieldsynopsis> + <type>int</type><varname>current_field</varname> + </fieldsynopsis> + </classsynopsis> + <para> + Retourne la position du champs dans un pointeur utilisée + par le dernier appel à <function>mysqli_fetch_field</function>. + Cette valeur peut être utilisée comme argument à la fonction + <function>mysqli_field_seek</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la position du champs courant dans le curseur. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <example> + <title>Style orienté objet</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -62,7 +73,7 @@ /* Récupération de la position du champ dans le curseur */ $currentfield = $result->current_field; - printf("Colonne %d:\n", $currentfield); + printf("Colonne %d:\n", $currentfield); printf("Nom : %s\n", $finfo->name); printf("Table : %s\n", $finfo->table); printf("Longueur Max. : %d\n", $finfo->max_length); @@ -76,18 +87,18 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Style procédural</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Style procédural</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { - printf("Echec de la connexion : %s\n", mysqli_connect_error()); + printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } @@ -98,10 +109,10 @@ /* Récupération des informations des champs pour toutes les colonnes */ while ($finfo = mysqli_fetch_field($result)) { - /* Récupération de la position du champ dans le curseur */ + /* Récupération de la position du champs dans le curseur */ $currentfield = mysqli_field_tell($result); - printf("Colonne %d:\n", $currentfield); + printf("Colonne %d:\n", $currentfield); printf("Nom : %s\n", $finfo->name); printf("Table : %s\n", $finfo->table); printf("Longueur Max. : %d\n", $finfo->max_length); @@ -115,10 +126,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Colonne 1: Nom : Name @@ -135,16 +146,20 @@ Type : 4 ]]> - </screen> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_field</function> et - <function>mysqli_field_seek</function>. - </para> - </refsect1> - </refentry> + </screen> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_fetch_field</function></member> + <member><function>mysqli_field_seek</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -165,4 +180,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/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-free-result.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-free-result.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-free-result.xml:1.11 phpdoc-fr/reference/mysqli/functions/mysqli-free-result.xml:1.12 --- phpdoc-fr/reference/mysqli/functions/mysqli-free-result.xml:1.11 Fri Nov 18 05:52:59 2005 +++ phpdoc-fr/reference/mysqli/functions/mysqli-free-result.xml Fri Feb 2 13:04:49 2007 @@ -1,66 +1,78 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.mysqli-free-result"> - <refnamediv> - <refname>mysqli_free_result</refname> - <refname>result->free</refname> - <refpurpose>Libère la mémoire associée à un résultat</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - &title.procedural; - <methodsynopsis> - <type>void</type><methodname>mysqli_free_result</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Style orienté objet (toutes les méthodes sont équivalentes)</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>void</type><methodname>free</methodname> - <void /> - </methodsynopsis> - <methodsynopsis> - <type>void</type><methodname>close</methodname> - <void /> - </methodsynopsis> - <methodsynopsis> - <type>void</type><methodname>free_result</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - La fonction <function>mysqli_free_result</function> libère la mémoire - associée au résultat représenté par le paramètre - <parameter>result</parameter>, qui a été allouée par <function>mysqli_query</function>, - <function>mysqli_store_result</function> - ou <function>mysqli_use_result</function>. - </para> - <note> - <para> - Vous devriez toujours libérer les résultats avec <function>mysqli_free_result</function>, - lorsque votre objet de résultat ne vous est plus utile. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - <function>mysqli_free_result</function> ne retourne aucune valeur. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_query</function>, - <function>mysqli_stmt_store_result</function>, - <function>mysqli_store_result</function> et - <function>mysqli_use_result</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.mysqli-free-result"> + <refnamediv> + <refname>mysqli_free_result</refname> + <refname>result->free()</refname> + <refpurpose>Libère la mémoire associée à un résultat</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + &title.procedural; + <methodsynopsis> + <type>void</type><methodname>mysqli_free_result</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + &title.oop; + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>void</type><methodname>free</methodname> + <void /> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>close</methodname> + <void /> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>free_result</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Libère la mémoire associée au résultat. + </para> + <note> + <para> + Vous devriez toujours libérer les résultats avec <function>mysqli_free_result</function>, + lorsque votre objet de résultat ne vous est plus utile. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &mysqli.result.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>mysqli_query</function></member> + <member><function>mysqli_stmt_store_result</function></member> + <member><function>mysqli_store_result</function></member> + <member><function>mysqli_use_result</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -81,4 +93,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