my_ulonglong mysql_insert_id(MYSQL *mysql)
Descrição
Retorna o ID gerado para uma coluna
AUTO_INCREMENT
pela consulta anterior. Use
esta função depois de ter realizado um consulta
INSERT
em uma tabela que contenha um campo
AUTO_INCREMENT
.
Note que mysql_insert_id()
retorna
0
se a consulta anterior não gerar um
valor AUTO_INCREMENT
. Se você desejar
salvar o valor para uso posterior, chame
mysql_insert_id()
imediatamente depois da
consulta que gerou o valor.
Se a consulta anterior retornar um erro, o valor de
mysql_insert_id()
é indefinido.
mysql_insert_id()
é atualizado depois de
instruções INSERT
e
UPDATE
que geram um valor
AUTO_INCREMENT
ou que definem um valor de
coluna com LAST_INSERT_ID(expr)
. See
Secção 6.3.6.2, “Funções Diversas”.
Note também que o valor da função SQL
LAST_INSERT_ID()
sempre contém o o valor
AUTO_INCREMENT
gerado mais recentemente e
não é zerado entre as consultas porque o valor desta
função é mantido no servidor.
Valor Retornado
O valor do campo AUTO_INCREMENT
que foi
atualizado pela consulta anterior. Retorna zero se não houve
consultas anteriores na conexão ou se a consulta não
atualizou o valor AUTO_INCREMENT
.
Erros
Nenhum.
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.