my_ulonglong mysql_insert_id(MYSQL *mysql)
Описание
Возвращает идентификатор ID
, сгенерированный для столбца AUTO_INCREMENT
предыдущим запросом. Эту функцию следует использовать после выполнения
запроса INSERT
в таблице, содержащей поле AUTO_INCREMENT
.
Следует учитывать, что функция mysql_insert_id()
возвращает 0, если
предыдущий запрос не сформировал величину AUTO_INCREMENT
. Если необходимо
сохранить эту величину в дальнейшем, то следует позаботиться о вызове
функции mysql_insert_id()
немедленно после запроса, который создает
указанную величину.
Функция mysql_insert_id()
обновляется после команд INSERT
и UPDATE
,
которые генерируют величину AUTO_INCREMENT
или устанавливают величину
столбца в значение LAST_INSERT_ID(expr)
. See Раздел 6.3.6.2, «Разные функции».
Следует также иметь в виду, что величина SQL-функции LAST_INSERT_ID()
всегда содержит самое последнее сгенерированное значение AUTO_INCREMENT
и
не обновляется между запросами, так как величина этой функции сохраняется
сервером.
Возвращаемые значения
Величина поля AUTO_INCREMENT
, обновленного предыдущим запросом.
Возвращает нуль, если перед этим не было запроса в данном соединении или
если данный запрос не обновил величину AUTO_INCREMENT
.
Ошибки
Нет.