int mysql_next_result(MYSQL *mysql)
Beschreibung
Wenn noch Anfrageergebnisse vorliegen, liest
mysql_next_result()
die nächsten
Ergebnisse und gibt den Status an die Anwendung zurück.
Sie müssen für die vorherige Anfrage
mysql_free_result()
aufrufen, falls diese
eine Ergebnismenge zurückgegeben hat.
Nach einem Aufruf von mysql_next_result()
hat die Verbindung denselben Status, als hätten Sie
mysql_real_query()
oder
mysql_query()
für die nächste Anfrage
aufgerufen. Das bedeutet, dass Sie
mysql_store_result()
,
mysql_warning_count()
,
mysql_affected_rows()
und so weiter
aufrufen können.
Wenn mysql_next_result()
einen Fehler
zurückgibt, werden andere Anweisungen ausgeführt und es
liegen keine Ergebnisse mehr zum Abruf bereit.
Siehe Abschnitt 24.2.9, „C-API: Behandlung der Ausführung mehrerer Anweisungen“.
Rückgabewerte
Rückgabewert | Beschreibung |
0 | Erfolg, und es gibt noch mehr Ergebnisse. |
-1 | Erfolg, und es gibt keine Ergebnisse mehr. |
>0 | Ein Fehler ist aufgetreten |
Fehler
CR_COMMANDS_OUT_OF_SYNC
Befehle wurden in der falschen Reihenfolge ausgeführt,
beispielsweise wenn Sie es versäumt haben,
mysql_use_result()
für die vorherige
Ergebnismenge aufzurufen.
CR_SERVER_GONE_ERROR
Der MySQL Server ist nicht mehr verfügbar.
CR_SERVER_LOST
Die Serververbindung brach während der Anfrage ab.
CR_UNKNOWN_ERROR
Ein unbekannter Fehler ist aufgetreten.
Dies ist eine Übersetzung des MySQL-Referenzhandbuchs, das sich auf dev.mysql.com befindet. Das ursprüngliche Referenzhandbuch ist auf Englisch, und diese Übersetzung ist nicht notwendigerweise so aktuell wie die englische Ausgabe. Das vorliegende deutschsprachige Handbuch behandelt MySQL bis zur Version 5.1.