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

# db2_num_rows

(PECL ibm_db2 >= 1.0.0)

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

### Description

function db2_num_rows(resource `$stmt`): int|false

Retourne le nombre de lignes supprimées, ajoutées, mises à jour par une requête SQL.

Afin de déterminer le nombre de lignes que retournera une requête SELECT, il faut exécuter la requête SELECT COUNT(*) avec les mêmes prédicats que la requête SELECT prévue et récupérer la valeur.

Si la logique de l'application vérifie le nombre de lignes retournées par une requête SELECT et effectue un branchement si le nombre de lignes est 0, il est recommandé de modifier l'application pour tenter de retourner la première ligne avec db2_fetch_assoc(), db2_fetch_both(), db2_fetch_array() ou db2_fetch_row(), et d'effectuer le branchement si la fonction retourne `false`.

> Note: Lors de l'envoi d'une requête SELECT avec un curseur flottant, db2_num_rows() retourne le nombre de lignes retournées par la requête SELECT. Cependant, le temps système associé aux curseurs flottants dégrade considérablement les performances de l'application, ainsi, si cela est la seule raison pour laquelle l'on envisage d'utiliser des curseurs flottants, il est recommandé d'utiliser un curseur à avancement seul et soit d'appeler SELECT COUNT(*), soit de s'appuyer sur la valeur de retour de type bool des fonctions de récupération pour obtenir une fonctionnalité équivalente avec des performances bien meilleures.

### Liste de paramètres

`stmt`
  Une ressource `stmt` valide contenant le jeu de résultats.

### Valeurs de retour

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, ou `false` si une erreur survient

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open