- Documentation Library
- Table of Contents
- MySQL 5.0 Manual
- Table of Contents
- 24.2.7 Description des fonctions C pour les requêtes préparées
- 24.2.7.1 mysql_stmt_affected_rows()
- 24.2.7.2 mysql_stmt_attr_get()
- 24.2.7.3 mysql_stmt_attr_set()
- 24.2.7.4 mysql_stmt_bind_param()
- 24.2.7.5 mysql_stmt_bind_result()
- 24.2.7.6 mysql_stmt_close()
- 24.2.7.7 mysql_stmt_data_seek()
- 24.2.7.8 mysql_stmt_errno()
- 24.2.7.9 mysql_stmt_error()
- 24.2.7.10 mysql_stmt_execute()
- 24.2.7.11 mysql_stmt_free_result()
- 24.2.7.12 mysql_stmt_insert_id()
- 24.2.7.13 mysql_stmt_fetch()
- 24.2.7.14 mysql_stmt_fetch_column()
- 24.2.7.15 mysql_stmt_field_count()
- 24.2.7.16 mysql_stmt_init()
- 24.2.7.17 mysql_stmt_num_rows()
- 24.2.7.18 mysql_stmt_param_count()
- 24.2.7.19 mysql_stmt_param_metadata()
- 24.2.7.20 mysql_stmt_prepare()
- 24.2.7.21 mysql_stmt_reset()
- 24.2.7.22 mysql_stmt_result_metadata()
- 24.2.7.23 mysql_stmt_row_seek()
- 24.2.7.24 mysql_stmt_row_tell()
- 24.2.7.25 mysql_stmt_send_long_data()
- 24.2.7.26 mysql_stmt_sqlstate()
- 24.2.7.27 mysql_stmt_store_result()
my_ulonglong mysql_stmt_affected_rows(MYSQL_STMT
*stmt)
Description
Retourne le nombre total de ligne modifiées par la dernière commande. Cette fonction peut être appelée immédiatement après la fonction mysql_execute() pour les commandes UPDATE, DELETE ou INSERT. Pour les commandes SELECT, mysql_stmt_affected() fonctionne comme mysql_num_rows().
Valeurs retournées
Un entier supérieur à zéro indique le nombre de ligne
affectées ou lues. Zéro indique qu'aucune ligne n'a été
modifiées durant une commande UPDATE, ou qu'aucune ligne n'a
vérifié la clause WHERE dans la requête, ou qu'aucune
requête n'a été exécuté. −1 indique que la requête a
retourné une erreur, ou que, pour une requête SELECT,
mysql_stmt_affected_rows() a été appelé avant
mysql_fetch(). Comme
mysql_stmt_affected_rows() retourne une
valeur non signée, vous pouvez surveiller la valeur −1 en
analysant la valeur retournée par
(my_ulonglong)-1 (ou to
(my_ulonglong)~0, qui est équivalent).
Erreurs
Aucune.
Exemple
Plus une illustration de
mysql_stmt_affected_rows() voyez l'exemple
de Section 24.2.7.10, « mysql_stmt_execute() ».
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.
