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.

Retornar