- 24.2.3 C-API: Funktionsbeschreibungen
- 24.2.3.1 mysql_affected_rows()
- 24.2.3.2 mysql_autocommit()
- 24.2.3.3 mysql_change_user()
- 24.2.3.4 mysql_character_set_name()
- 24.2.3.5 mysql_close()
- 24.2.3.6 mysql_commit()
- 24.2.3.7 mysql_connect()
- 24.2.3.8 mysql_create_db()
- 24.2.3.9 mysql_data_seek()
- 24.2.3.10 mysql_debug()
- 24.2.3.11 mysql_drop_db()
- 24.2.3.12 mysql_dump_debug_info()
- 24.2.3.13 mysql_eof()
- 24.2.3.14 mysql_errno()
- 24.2.3.15 mysql_error()
- 24.2.3.16 mysql_escape_string()
- 24.2.3.17 mysql_fetch_field()
- 24.2.3.18 mysql_fetch_field_direct()
- 24.2.3.19 mysql_fetch_fields()
- 24.2.3.20 mysql_fetch_lengths()
- 24.2.3.21 mysql_fetch_row()
- 24.2.3.22 mysql_field_count()
- 24.2.3.23 mysql_field_seek()
- 24.2.3.24 mysql_field_tell()
- 24.2.3.25 mysql_free_result()
- 24.2.3.26 mysql_get_character_set_info()
- 24.2.3.27 mysql_get_client_info()
- 24.2.3.28 mysql_get_client_version()
- 24.2.3.29 mysql_get_host_info()
- 24.2.3.30 mysql_get_proto_info()
- 24.2.3.31 mysql_get_server_info()
- 24.2.3.32 mysql_get_server_version()
- 24.2.3.33 mysql_hex_string()
- 24.2.3.34 mysql_info()
- 24.2.3.35 mysql_init()
- 24.2.3.36 mysql_insert_id()
- 24.2.3.37 mysql_kill()
- 24.2.3.38 mysql_library_end()
- 24.2.3.39 mysql_library_init()
- 24.2.3.40 mysql_list_dbs()
- 24.2.3.41 mysql_list_fields()
- 24.2.3.42 mysql_list_processes()
- 24.2.3.43 mysql_list_tables()
- 24.2.3.44 mysql_more_results()
- 24.2.3.45 mysql_next_result()
- 24.2.3.46 mysql_num_fields()
- 24.2.3.47 mysql_num_rows()
- 24.2.3.48 mysql_options()
- 24.2.3.49 mysql_ping()
- 24.2.3.50 mysql_query()
- 24.2.3.51 mysql_real_connect()
- 24.2.3.52 mysql_real_escape_string()
- 24.2.3.53 mysql_real_query()
- 24.2.3.54 mysql_refresh()
- 24.2.3.55 mysql_reload()
- 24.2.3.56 mysql_rollback()
- 24.2.3.57 mysql_row_seek()
- 24.2.3.58 mysql_row_tell()
- 24.2.3.59 mysql_select_db()
- 24.2.3.60 mysql_set_character_set()
- 24.2.3.61 mysql_set_server_option()
- 24.2.3.62 mysql_shutdown()
- 24.2.3.63 mysql_sqlstate()
- 24.2.3.64 mysql_ssl_set()
- 24.2.3.65 mysql_stat()
- 24.2.3.66 mysql_store_result()
- 24.2.3.67 mysql_thread_id()
- 24.2.3.68 mysql_use_result()
- 24.2.3.69 mysql_warning_count()
my_ulonglong mysql_insert_id(MYSQL *mysql)
Beschreibung
Liefert den von der vorherigen INSERT- oder
UPDATE-Anweisung für eine
AUTO_INCREMENT-Spalte generierten Wert.
Verwenden Sie diese Funktion, wenn Sie eine
INSERT-Anweisung auf einer Tabelle mit
einem AUTO_INCREMENT-Feld ausgeführt
haben.
Genauer gesagt: mysql_insert_id() wird
unter folgenden Bedingungen aktualisiert:
INSERT-Anweisungen, die einen Wert in einerAUTO_INCREMENT-Spalte speichern, und zwar unabhängig davon, ob der Wert automatisch durch Speichern der SpezialwerteNULLoder0in der Spalte generiert oder ob ein expliziter, nichtspezieller Wert gespeichert wurde.Bei einer mehrzeiligen
INSERT-Anweisung liefertmysql_insert_id()den ersten automatisch generiertenAUTO_INCREMENT-Wert. Wurde kein solcher Wert generiert, liefert die Funktion den letzten explizit in dieAUTO_INCREMENT-Spalte eingefügten Wert.INSERT-Anweisungen, die einenAUTO_INCREMENT-Wert generieren, indem sieLAST_INSERT_ID(in eine Spalte einfügen.expr)INSERT-Anweisungen, die einenAUTO_INCREMENT-Wert generieren, indem sie eine Spalte aufLAST_INSERT_ID(setzen.expr)Der Wert von
mysql_insert_id()wird nicht von Anweisungen wieSELECTbeeinflusst, die eine Ergebnismenge zurückgeben.Wenn die obige Anweisung einen Fehler zurückgab, ist der Wert von
mysql_insert_id()undefiniert.
Beachten Sie, dass mysql_insert_id() den
Wert 0 liefert, wenn die Anweisung keinen
AUTO_INCREMENT-Wert verwendet. Wenn Sie den
Wert zur späteren Benutzung speichern möchten, müssen Sie
unmittelbar nach der Anweisung, die den Wert generiert,
mysql_insert_id() aufrufen.
Der Wert von mysql_insert_id() wird nur von
Anweisungen beeinflusst, die innerhalb der aktuellen
Clientverbindung gegeben werden, aber nicht durch Anweisungen
von anderen Clients.
Siehe Abschnitt 12.10.3, „Informationsfunktionen“.
Bitte beachten Sie auch, dass der Wert der SQL-Funktion
LAST_INSERT_ID() immer den zuletzt
generierten AUTO_INCREMENT-Wert enthält.
Dieser wird zwischen zwei Anweisungen nicht zurückgesetzt, da
der Wert dieser Funktion im Server gespeichert ist. Ein
weiterer Unterschied ist der, dass
LAST_INSERT_ID() nicht aktualisiert wird,
wenn Sie eine AUTO_INCREMENT-Spalte auf
einen bestimmten Wert setzen, der kein Spezialwert ist.
Der Grund für den Unterschied zwischen
LAST_INSERT_ID() und
mysql_insert_id() besteht darin, dass
LAST_INSERT_ID() in Skripten einfach zu
benutzen sein soll, während
mysql_insert_id() versucht, etwas genauere
Informationen über die Vorgänge in der
AUTO_INCREMENT-Spalte zu liefern.
Rückgabewerte
Siehe oben.
Fehler
Keine.
Dies ist eine Übersetzung des MySQL-Referenzhandbuchs, das sich auf dev.mysql.com befindet. Das ursprüngliche Referenzhandbuch ist auf Englisch, und diese Übersetzung ist nicht notwendigerweise so aktuell wie die englische Ausgabe. Das vorliegende deutschsprachige Handbuch behandelt MySQL bis zur Version 5.1.
