- Documentation Library
- Table of Contents
- MySQL 5.0 Manual
- Table of Contents
- 24.2.3 Description des fonctions de l'API C
- 24.2.3.1 mysql_affected_rows()
- 24.2.3.2 mysql_change_user()
- 24.2.3.3 mysql_character_set_name()
- 24.2.3.4 mysql_close()
- 24.2.3.5 mysql_connect()
- 24.2.3.6 mysql_create_db()
- 24.2.3.7 mysql_data_seek()
- 24.2.3.8 mysql_debug()
- 24.2.3.9 mysql_drop_db()
- 24.2.3.10 mysql_dump_debug_info()
- 24.2.3.11 mysql_eof()
- 24.2.3.12 mysql_errno()
- 24.2.3.13 mysql_error()
- 24.2.3.14 mysql_escape_string()
- 24.2.3.15 mysql_fetch_field()
- 24.2.3.16 mysql_fetch_fields()
- 24.2.3.17 mysql_fetch_field_direct()
- 24.2.3.18 mysql_fetch_lengths()
- 24.2.3.19 mysql_fetch_row()
- 24.2.3.20 mysql_field_count()
- 24.2.3.21 mysql_field_seek()
- 24.2.3.22 mysql_field_tell()
- 24.2.3.23 mysql_free_result()
- 24.2.3.24 mysql_get_client_info()
- 24.2.3.25 mysql_get_client_version()
- 24.2.3.26 mysql_get_host_info()
- 24.2.3.27 mysql_get_proto_info()
- 24.2.3.28 mysql_get_server_info()
- 24.2.3.29 mysql_get_server_version()
- 24.2.3.30 mysql_hex_string()
- 24.2.3.31 mysql_info()
- 24.2.3.32 mysql_init()
- 24.2.3.33 mysql_insert_id()
- 24.2.3.34 mysql_kill()
- 24.2.3.35 mysql_library_end()
- 24.2.3.36 mysql_library_end()
- 24.2.3.37 mysql_list_dbs()
- 24.2.3.38 mysql_list_fields()
- 24.2.3.39 mysql_list_processes()
- 24.2.3.40 mysql_list_tables()
- 24.2.3.41 mysql_num_fields()
- 24.2.3.42 mysql_num_rows()
- 24.2.3.43 mysql_options()
- 24.2.3.44 mysql_ping()
- 24.2.3.45 mysql_query()
- 24.2.3.46 mysql_real_connect()
- 24.2.3.47 mysql_real_escape_string()
- 24.2.3.48 mysql_real_query()
- 24.2.3.49 mysql_reload()
- 24.2.3.50 mysql_row_seek()
- 24.2.3.51 mysql_row_tell()
- 24.2.3.52 mysql_select_db()
- 24.2.3.53 mysql_set_server_option()
- 24.2.3.54 mysql_shutdown()
- 24.2.3.55 mysql_sqlstate()
- 24.2.3.56 mysql_ssl_set()
- 24.2.3.57 mysql_stat()
- 24.2.3.58 mysql_store_result()
- 24.2.3.59 mysql_thread_id()
- 24.2.3.60 mysql_use_result()
- 24.2.3.61 mysql_warning_count()
- 24.2.3.62 mysql_commit()
- 24.2.3.63 mysql_rollback()
- 24.2.3.64 mysql_autocommit()
- 24.2.3.65 mysql_more_results()
- 24.2.3.66 mysql_next_result()
my_ulonglong mysql_insert_id(MYSQL *mysql)
Description
Retourne l'identifiant généré pour une colonne
AUTO_INCREMENT par la dernière requête.
Utilisez cette commande après avoir exécuté une requête
INSERT sur une table qui contient un champ
AUTO_INCREMENT.
Plus précisément, mysql_insert_id() est
mis à jour dans ces conditions :
Les commandes
INSERTqui stockent une valeur dans une colonne de typeAUTO_INCREMENT. C'est vrai si la valeur est automatiquement générée suivant le stockage deNULLou0dans la colonne, ou une valeur explicite non-spéciale.Dans le cas des
INSERTmultiples,mysql_insert_id()retourne la première valeurAUTO_INCREMENTautomatiquement générée : si aucune valeur n'est générée, elle retourne la dernière valeur explicitement insérée dans la colonneAUTO_INCREMENT.Les commandes
INSERTqui génère une valeurAUTO_INCREMENTen insérant l'expressionLAST_INSERT_ID(expr)dans une colonne.Les commandes
INSERTqui génèrent une valeurAUTO_INCREMENTqui donne la valeur deLAST_INSERT_ID(expr)à une colonne.La valeur de
mysql_insert_id()n'est pas affectée par les commandes telles que les commandesSELECTqui ne retournent pas de résultat.Si la commande précédent a retourné une erreur, la valeur de
mysql_insert_id()est indéfinie.
Notez que mysql_insert_id() retourne
0 si la dernière requête n'a pas
généré de valeur AUTO_INCREMENT. Si vous
voulez garder cette valeur pour plus tard, assurez vous
d'appeler mysql_insert_id() immédiatement
après la requête ayant généré cette valeur.
mysql_insert_id() est mis à jour après
l'exécution de requêtes INSERT et
UPDATE qui génèrent une valeur
AUTO_INCREMENT ou qui définissent la
valeur d'une colonne à
LAST_INSERT_ID(expr). See
Section 12.8.4, « Fonctions diverses ».
Notez aussi que la valeur de retour de la fonction SQL
LAST_INSERT_ID() contient toujours la
valeur d'AUTO_INCREMENT la plus à jour.
Cette valeur n'est pas remise à zéro lors de l'exécution
d'autre requêtes car elle est maintenue pour le serveur.
Valeur de retour
La valeur de la colonne AUTO_INCREMENT qui
a été mise à jour par la dernière requête. Retourne zéro
si aucune requête n'avait eu lieu durant la connexion, ou si
la dernière requête n'a pas mis à jour la valeur de la
colonne AUTO_INCREMENT.
Erreurs
Aucune.
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.
