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

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

Voir aussi

  • ifx_num_rows() - Compte le nombre de lignes déjà lues dans un résultat

LoadingChargement en cours