Constantes pré-définies
<<<		 mysqli_affected_rows mysqli_autocommit
>>>
8.78 Extension MySQL améliorée
8 Référence des fonctions
 Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Classes pré-définies
. Constantes pré-définies
->mysqli_affected_rows
. mysqli_autocommit
. mysqli_bind_param
. mysqli_bind_result
. mysqli_change_user
. mysqli_character_set_name
. mysqli_client_encoding
. mysqli_close
. mysqli_commit
. mysqli_connect_errno
. mysqli_connect_error
. mysqli_connect
. mysqli_data_seek
. mysqli_debug
. mysqli_disable_reads_from_master
. mysqli_disable_rpl_parse
. mysqli_dump_debug_info
. mysqli_embedded_connect
. mysqli_enable_reads_from_master
. mysqli_enable_rpl_parse
. mysqli_errno
. mysqli_error
. mysqli_escape_string
. mysqli_execute
. mysqli_fetch_array
. mysqli_fetch_assoc
. mysqli_fetch_field_direct
. mysqli_fetch_field
. mysqli_fetch_fields
. mysqli_fetch_lengths
. mysqli_fetch_object
. mysqli_fetch_row
. mysqli_fetch
. mysqli_field_count
. mysqli_field_seek
. mysqli_field_tell
. mysqli_free_result
. mysqli_get_client_info
. mysqli_get_client_version
. mysqli_get_host_info
. mysqli_get_metadata
. mysqli_get_proto_info
. mysqli_get_server_info
. mysqli_get_server_version
. mysqli_info
. mysqli_init
. mysqli_insert_id
. mysqli_kill
. mysqli_master_query
. mysqli_more_results
. mysqli_multi_query
. mysqli_next_result
. mysqli_num_fields
. mysqli_num_rows
. mysqli_options
. mysqli_param_count
. mysqli_ping
. mysqli_prepare
. mysqli_query
. mysqli_real_connect
. mysqli_real_escape_string
. mysqli_real_query
. mysqli_report
. mysqli_rollback
. mysqli_rpl_parse_enabled
. mysqli_rpl_probe
. mysqli_rpl_query_type
. mysqli_select_db
. mysqli_send_long_data
. mysqli_send_query
. mysqli_server_end
. mysqli_server_init
. mysqli_set_opt
. mysqli_sqlstate
. mysqli_ssl_set
. mysqli_stat
. mysqli_stmt_affected_rows
. mysqli_stmt_bind_param
. mysqli_stmt_bind_result
. mysqli_stmt_close
. mysqli_stmt_data_seek
. mysqli_stmt_errno
. mysqli_stmt_error
. mysqli_stmt_execute
. mysqli_stmt_fetch
. mysqli_stmt_free_result
. mysqli_stmt_init
. mysqli_stmt_num_rows
. mysqli_stmt_param_count
. mysqli_stmt_prepare
. mysqli_stmt_reset
. mysqli_stmt_result_metadata
. mysqli_stmt_send_long_data
. mysqli_stmt_sqlstate
. mysqli_stmt_store_result
. mysqli_store_result
. mysqli_thread_id
. mysqli_thread_safe
. mysqli_use_result
. mysqli_warning_count

8.78.7 mysqli_affected_rows()mysqli->affected_rows() Retourne le nombre de lignes affectées par la dernière opération MySQL

[ Exemples avec mysqli_affected_rows ]   PHP 5

Style procédural

mixed  mysqli_affected_rows ( mysqli   link )

Style orienté objet (méthode)

mysqli mixed affected_rows

mysqli_affected_rows retourne le nombre de lignes affectées par la dernière requête INSERT, UPDATE, ou DELETE associée au paramètre link . Si la dernière requête était invalide, cette fonction retournera -1.

Note

Pour les requêtes de type SELECT, mysqli_affected_rows est identique à la fonction mysqli_num_rows .

La fonction mysqli_affected_rows ne fonctionne que pour les requêtes qui modifient une table. Pour connaître le nombre de lignes retournées par une requête SELECT, utilisez la fonction mysqli_num_rows .

Un entier plus grand que zéro indique le nombre de lignes affectées ou recherchées. Zéro indique qu'aucun enregistrement n'a été modifié par une requête du type UPDATE, aucune ligne ne correspond à la clause WHERE dans la requête ou bien qu'aucune requête n'a été exécutée. -1 indique que la requête a retourné une erreur.

Note

Si le nombre de lignes affectées est plus grand que la valeur maximale que peut prendre un entier, le nombre de lignes affectées sera retourné en tant que chaîne de caractères.

mysqli_num_rows et mysqli_info .

Style orienté objet

<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* Vérification de la connexion */
if (mysqli_connect_errno()) {
    printf("Erreur de connexion : %s\n", mysqli_connect_error());
    exit();
}

/* Insertion d'une ligne */
$mysqli->query("CREATE TABLE Language SELECT * from CountryLanguage");
printf("Nombre de lignes affectées (INSERT): %d\n", $mysqli->affected_rows);

$mysqli->query("ALTER TABLE Language ADD Status int default 0");

/* Modification d'une ligne */
$mysqli->query("UPDATE Language SET Status=1 WHERE Percentage > 50");
printf("Nombre de lignes affectées (UPDATE): %d\n", $mysqli->affected_rows);

/* Effacement d'une ligne */
$mysqli->query("DELETE FROM Language WHERE Percentage < 50");
printf("Nombre de lignes affectées (DELETE): %d\n", $mysqli->affected_rows);

/* Sélection de toutes les lignes */
$result = $mysqli->query("SELECT CountryCode FROM Language");
printf("Nombre de lignes affectées (SELECT): %d\n", $mysqli->affected_rows);

$result->close();

/* Effacement de la table "Language" */
$mysqli->query("DROP TABLE Language");

/* Fermeture de la connexion */
$mysqli->close();
?>
Style procédural

<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

if (!$link) {
    printf("Connexion impossible à localhost. Erreur : %s\n", mysqli_connect_error());
    exit();
}

/* Insertion d'une ligne */
mysqli_query($link, "CREATE TABLE Language SELECT * from CountryLanguage");
printf("Nombre de lignes affectées (INSERT): %d\n", mysqli_affected_rows($link));

mysqli_query($link, "ALTER TABLE Language ADD Status int default 0");

/* Modification d'une ligne */
mysqli_query($link, "UPDATE Language SET Status=1 WHERE Percentage > 50");
printf("Nombre de lignes affectées (UPDATE): %d\n", mysqli_affected_rows($link));

/* Effacement d'une ligne */
mysqli_query($link, "DELETE FROM Language WHERE Percentage < 50");
printf("Nombre de lignes affectées (DELETE): %d\n", mysqli_affected_rows($link));

/* Selection de toutes les lignes */
$result = mysqli_query($link, "SELECT CountryCode FROM Language");
printf("Nombre de lignes affectées (SELECT): %d\n", mysqli_affected_rows($link));

mysqli_free_result($result);

/* Effacement de la table "language" */
mysqli_query($link, "DROP TABLE Language");

/* Fermeture de la connexion */
mysqli_close($link);
?>

L'exemple ci-dessus va afficher :


Affected rows (INSERT): 984
Affected rows (UPDATE): 168
Affected rows (DELETE): 815
Affected rows (SELECT): 169

<< mysqli_affected_rows >>
Constantes pré-définies Extension MySQL améliorée mysqli_autocommit