Manuel PHP

ifx_affected_rows

(PHP 4, PHP <=5.2.0)

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

Description

int ifx_affected_rows ( resource $result_id )

Retourne le nombre de lignes affectées par la requête associée à result_id .

Pour les INSERT, UPDATE et DELETE, ce nombre est le nombre exact de lignes affectées (sqlerrd[2]). Pour les SELECT, ce n'est qu'une estimation (sqlerrd[0]). Ne vous y fiez pas. Le serveur de base de données ne peut jamais retourner le nombre de lignes actuel qui sera retourné par une requête SELECT car il n'a pas commencé à les récupérer ce stade (juste après "PREPARE", lorsque l'optimisateur a déterminé le plan de requête).

ifx_affected_rows() est très pratique après ifx_prepare() pour limiter la taille des résultats.

Liste de paramètres

result_id

Un identifiant de résultat valide retourné par la fonction ifx_query() ou la fonction ifx_prepare().

Valeurs de retour

Retourne le nombre de lignes, sous la forme d'un entier.

Exemples

Exemple #1 Nombre de lignes affectées

  1. <?php
  2. $rid = ifx_prepare("select * from emp
  3.                 where name like " . $name, $connid);  
  4. if (! $rid) { 
  5.    /* ... erreur ... */  
  6. }  
  7. $rowcount = ifx_affected_rows($rid);  
  8. if ($rowcount > 1000) { 
  9.    printf ("Trop de lignes trouvées (%d)\n<br />", $rowcount); 
  10.    die ("Rééssayez avec une autre requête.<br />\n");  
  11. }  
  12. ?> 

Voir aussi


Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique