mysql.h


Función mysql_next_result()

int mysql_next_result(MYSQL *mysql)

Si existen más resultados de consultas, mysql_next_result() lee los siguientes resultados de consulta y devuelve el estado a la aplicación.

Se debe llamar a mysql_free_result() para la consulta anterior si devolvión un conjunto de resultados.

Después de llamar a mysql_next_result() el estado de la conexión es el mismo que si se hubiese llamado a mysql_real_query() o a mysql_query() para la siguiente consulta. Esto significa que se puede llamar a mysql_store_result(), mysql_warning_count(), mysql_affected_rows(), etc.

Si mysql_next_result() devuelve un error, no se ejecutará ninguna otra sentencia y no hay más resultados a recuperar.

Esta función se añadió en MySQL 4.1.0.

Valores de retorno

Valor de retorno Descripción
0 Éxito y hay más resultados
-1 Éxito y no hay más resultados
>0 Se ha producido un error

Errores

CR_COMMANDS_OUT_OF_SYNC: Los comandos fueron ejecutados en un orden inapropiado.

CR_SERVER_GONE_ERROR: El servidor MySQL no está presente.

CR_SERVER_LOST: La conexión al servidor se perdió durante la consulta.

CR_UNKNOWN_ERROR: Se ha producido un error desconocido.