int mysql_next_result(MYSQL *mysql)
Descrição
Se existem mais resultados da consulta,
mysql_next_result()
lê o próximo
resultado da consulta e retorna o status a aplicação.
Disponível no MySQL 4.1
Note que você deve chamar
mysql_free_result()
para a consulta
anterior se ela retornar um resultado.
Depois de chamar mysql_next_result()
o
estado da conexão é como se tivesse chamado
mysql_real_query()
para a prima consulta.
Isto significa que você agora pode chamar
mysql_store_result()
,
mysql_warning_count()
,
mysql_affected_rows()
... na conexão.
Se mysql_next_result()
retorna um erro,
nenhuma outra instrução será executada e não haverá mais
resultado para buscar.
See Secção 12.1.8, “Tratando a Execução de Múltiplas Consultas na API C”.
Valor Retornado
0 em caso de sucesso e haver mais resultados. -1 se não houver mais resultados. > 0 se ocorrer um erro.
Erros
CR_COMMANDS_OUT_OF_SYNC
Os comando foram executados em uma ordem inpropriada. Por
exemplo se você não chamar
mysql_use_result()
para um resulatdo
anterior.
CR_SERVER_GONE_ERROR
O servidor MySQL foi finalizado.
CR_SERVER_LOST
A conexão ao servidor MySQL foi perdida durante a consulta.
CR_UNKNOWN_ERROR
Um erro desconhecido ocorreu.
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.