mysql_insert_id()
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)
. Leia "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.