<?xml version="1.0" encoding="utf-8"?>

<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-num-rows">

<refnamediv>

<refname>db2_num_rows</refname>

<refpurpose>

Retourne le nombre de lignes affectées par une requête SQL

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>int</type><type>false</type></type><methodname>db2_num_rows</methodname>

<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>

</methodsynopsis>

<simpara>

Retourne le nombre de lignes supprimées, ajoutées, mises à jour par une

requête SQL.

</simpara>

<simpara>

Afin de déterminer le nombre de lignes que retournera une requête SELECT,

utiliser la requête SELECT COUNT(*) avec les mêmes attributs lorsqu'on

a effectué la requête SELECT et la récupération des valeurs.

</simpara>

<simpara>

Si la logique de l'application vérifie le nombre de ligne retournée par

une requête SELECT et effectue le saut si le nombre de ligne est 0,

modifiez l'application pour tenter de retourner la première ligne avec

<function>db2_fetch_assoc</function>, <function>db2_fetch_both</function>,

<function>db2_fetch_array</function> ou <function>db2_fetch_row</function>,

et effectuez le saut si la fonction retourne &false;.

</simpara>

<note>

<simpara>

Lors de l'envoi d'une requête SELECT avec un curseur flottant,

<function>db2_num_rows</function> retournera le nombre de lignes retournées

par la requête SELECT. Cependant, le temps système associé avec des

curseurs flottants dégrade considérablement les performances de

l'application, alors si cela est la seule raison pour laquelle l'on utilise

des curseurs flottants, il est recommandé d'utiliser des curseurs à avancement

seul et de plus appeler SELECT COUNT(*) ou compter sur les valeurs de

retour des fonctions de type <type>bool</type> pour obtenir

l'équivalent de fonctionnalité avec une performance bien meilleure.

</simpara>

</note>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<variablelist>

<varlistentry>

<term><parameter>stmt</parameter></term>

<listitem>

<simpara>

Une ressource <literal>stmt</literal> valide contenant le jeu de

résultats.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<simpara>

Retourne le nombre de lignes affectées par la dernière requête SQL envoyée

par une fonction qui exécute les requêtes SQL, &return.falseforfailure;

</simpara>

</refsect1>

</refentry>