mysql_init()
<<<		 mysql_insert_id() mysql_kill()
>>>
21.2.3 Description des fonctions de l'API C
21.2 API MySQL C
21 API MySQL
 Manuel de Référence MySQL 4.1 : Version Française
. mysql_affected_rows()
. mysql_change_user()
. mysql_character_set_name()
. mysql_close()
. mysql_connect()
. mysql_create_db()
. mysql_data_seek()
. mysql_debug()
. mysql_drop_db()
. mysql_dump_debug_info()
. mysql_eof()
. mysql_errno()
. mysql_error()
. mysql_escape_string()
. mysql_fetch_field()
. mysql_fetch_fields()
. mysql_fetch_field_direct()
. mysql_fetch_lengths()
. mysql_fetch_row()
. mysql_field_count()
. mysql_field_seek()
. mysql_field_tell()
. mysql_free_result()
. mysql_get_client_info()
. mysql_get_client_version()
. mysql_get_host_info()
. mysql_get_proto_info()
. mysql_get_server_info()
. mysql_get_server_version()
. mysql_info()
. mysql_init()
->mysql_insert_id()
. mysql_kill()
. mysql_list_dbs()
. mysql_list_fields()
. mysql_list_processes()
. mysql_list_tables()
. mysql_num_fields()
. mysql_num_rows()
. mysql_options()
. mysql_ping()
. mysql_query()
. mysql_real_connect()
. mysql_real_escape_string()
. mysql_real_query()
. mysql_reload()
. mysql_row_seek()
. mysql_row_tell()
. mysql_select_db()
. mysql_set_server_option()
. mysql_shutdown()
. mysql_sqlstate()
. mysql_ssl_set()
. mysql_stat()
. mysql_store_result()
. mysql_thread_id()
. mysql_use_result()
. mysql_warning_count()
. mysql_commit()
. mysql_rollback()
. mysql_autocommit()
. mysql_more_results()
. mysql_next_result()

21.2.3.32 mysql_insert_id()

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 INSERT qui stockent une valeur dans une colonne de type AUTO_INCREMENT . C'est vrai si la valeur est automatiquement générée suivant le stockage de NULL ou 0 dans la colonne, ou une valeur explicite non-spéciale.
  • Dans le cas des INSERT multiples, mysql_insert_id() retourne la première valeur AUTO_INCREMENT automatiquement 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 colonne AUTO_INCREMENT .
  • Les commandes INSERT qui génère une valeur AUTO_INCREMENT en insérant l'expression LAST_INSERT_ID(expr) dans une colonne.
  • Les commandes INSERT qui génèrent une valeur AUTO_INCREMENT qui donne la valeur de LAST_INSERT_ID(expr) à une colonne.
  • La valeur de mysql_insert_id() n'est pas affectée par les commandes telles que les commandes SELECT qui 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) . 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.

<< mysql_insert_id() >>
mysql_init() Description des fonctions de l'API C mysql_kill()