8.80 MySQL
8 Référence des fonctions
Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. Notes
. Exemples
->mysql_affected_rows
. mysql_change_user
. mysql_client_encoding
. mysql_close
. mysql_connect
. mysql_create_db
. mysql_data_seek
. mysql_db_name
. mysql_db_query
. mysql_drop_db
. mysql_errno
. mysql_error
. mysql_escape_string
. mysql_fetch_array
. mysql_fetch_assoc
. mysql_fetch_field
. mysql_fetch_lengths
. mysql_fetch_object
. mysql_fetch_row
. mysql_field_flags
. mysql_field_len
. mysql_field_name
. mysql_field_seek
. mysql_field_table
. mysql_field_type
. mysql_free_result
. mysql_get_client_info
. mysql_get_host_info
. mysql_get_proto_info
. mysql_get_server_info
. mysql_info
. mysql_insert_id
. mysql_list_dbs
. mysql_list_fields
. mysql_list_processes
. mysql_list_tables
. mysql_num_fields
. mysql_num_rows
. mysql_pconnect
. mysql_ping
. mysql_query
. mysql_real_escape_string
. mysql_result
. mysql_select_db
. mysql_stat
. mysql_tablename
. mysql_thread_id
. mysql_unbuffered_query
|
8.80.9 mysql_affected_rows()
Retourne le nombre de lignes affectées lors de la dernière opération MySQL
[ Exemples avec mysql_affected_rows ] PHP 3, PHP 4, PHP 5
int
mysql_affected_rows (
resource
link_identifier
)
Retourne le nombre de lignes affectées lors de la dernière
requête INSERT, UPDATE ou DELETE avec
link_identifier
.
-
link_identifier
- La connexion MySQL.
S'il n'est pas spécifié, la dernière connexion ouverte avec la fonction
mysql_connect
sera utilisée. Si une telle connexion
n'est pas trouvée, la fonction tentera d'ouvrir une connexion, comme si
la fonction
mysql_connect
avait été appelée sans argument.
Si aucune connexion n'est trouvée ou établie, une alerte
E_WARNING
est générée.
Retourne le nombre de lignes affectées en cas de succès et -1 si la
dernière requête a échoué.
Si la dernière requête était un DELETE sans clause WHERE, tous
les enregistrements ont été effacés, mais cette fonction va
retourner 0 avec les versions de MySQL antérieures à 4.1.2.
Lorsque vous utilisez UPDATE, MySQL ne mettra pas à jour les colonnes si
la nouvelle valeur est identique à l'ancienne. Il est donc possible que
mysql_affected_rows
ne représente pas forcément
le nombre de lignes correspondantes mais plutôt le nombre de lignes
qui ont été réellement affectées par la requête.
La requête REPLACE commence par effacer les enregistrements possédant la même
clé primaire et ensuite, insert les nouveaux enregistrements. Cette fonction retourne le
nombre d'enregistrements effacés ainsi que le nombre d'enregistrements insérés.
| Exemple avec mysql_affected_rows |
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Impossible de se connecter : ' . mysql_error());
}
mysql_select_db('mydb');
/* Ceci devrait retourner le nombre correct de lignes effacées */
mysql_query('DELETE FROM mytable WHERE id < 10');
printf("Lignes effacées : %d\n", mysql_affected_rows());
/* avec la clause where qui n'est jamais vraie, on devrait obtenir 0 */
mysql_query('DELETE FROM mytable WHERE 0');
printf("Lignes effacées : %d\n", mysql_affected_rows());
?>
|
| Exemple avec mysql_affected_rows en utilisant les transactions |
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Impossible de se connecter : ' . mysql_error());
}
mysql_select_db('mydb');
/* Mise à jour des lignes */
mysql_query("UPDATE mytable SET used=1 WHERE id < 10");
printf ("Lignes modifiées : %d\n", mysql_affected_rows());
mysql_query("COMMIT");
?>
|
| Note | | Transactions
Si vous utilisez des transactions, vous devez appeler
mysql_affected_rows
après votre requête INSERT,
UPDATE ou DELETE et non après le COMMIT.
|
| Note | | Requêtes SELECT
Pour obtenir le nombre de lignes retournées par un SELECT, il est possible
d'utiliser
mysql_num_rows
.
|
|
