Files
doc-fr/reference/mysql/functions/mysql-num-rows.xml
2021-09-24 04:13:47 +01:00

130 lines
3.4 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mysql-num-rows" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysql_num_rows</refname>
<refpurpose>Retourne le nombre de lignes d'un résultat MySQL</refpurpose>
</refnamediv>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_num_rows</function></member>
<member><function>mysqli_stmt_num_rows</function></member>
<member><methodname>PDOStatement::rowCount</methodname></member>
</simplelist>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>int</type><type>false</type></type><methodname>mysql_num_rows</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
Récupère le nombre de lignes d'un jeu de résultat. Cette commande n'est
disponible que pour les requêtes comme SELECT ou SHOW qui retournent
un jeu de résultats. Pour récupérer le nombre de lignes
affectées par une requête INSERT, UPDATE, REPLACE ou DELETE, utilisez la
fonction <function>mysql_affected_rows</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&mysql.result.description;
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Le nombre de lignes dans un jeu de résultats en cas de succès&return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>mysql_num_rows</function></title>
<programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect("localhost", "mysql_user", "mysql_password");
mysql_select_db("database", $link);
$result = mysql_query("SELECT * FROM table1", $link);
$num_rows = mysql_num_rows($result);
echo "$num_rows Rows\n";
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Si vous utilisez <function>mysql_unbuffered_query</function>,
<function>mysql_num_rows</function> ne retournera pas
une valeur correcte tant que toutes les lignes du jeu de résultats
n'auront pas été récupérées.
</para>
</note>
<note>
<para>
&info.deprecated.alias;
<function>mysql_numrows</function>
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mysql_affected_rows</function></member>
<member><function>mysql_connect</function></member>
<member><function>mysql_data_seek</function></member>
<member><function>mysql_select_db</function></member>
<member><function>mysql_query</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->