560 MySQL - Technische Referenz f¨ur Version 5.0.1-alpha
R¨uckgabewerte
0, wenn der Befehl erfolgreich war. Nicht-0, wenn ein Fehler auftrat.
Fehler
CR_COMMANDS_OUT_OF_SYNC
Befehle wurden nicht in der korrekten Reihenfolge ausgef¨uhrt.
CR_SERVER_GONE_ERROR
Der MySQL-Server ist weg.
CR_SERVER_LOST
Die Verbindung zum Server ging w¨ahrend der Anfrage verloren.
CR_UNKNOWN_ERROR
Ein unbekannter Fehler trat auf.
9.4.3.11 mysql_eof()
my_bool mysql_eof(MYSQL_RES *result)
Beschreibung
Diese Funktion ist veraltet. Benutzen Sie statt dessen mysql_errno() oder mysql_error().
mysql_eof() stellt fest, ob die letzte Zeile einer Ergebnismenge gelesen wurde oder nicht.
Wenn Sie eine Ergebnismenge durch einen erfolgreichen Aufruf von mysql_store_result()
erhalten, erh¨alt der Client den gesamten Satz in einer Operation. In diesem Fall bedeutet
eine NULL-R¨uckgabe von mysql_fetch_row() immer, dass das Ende der Ergebnismenge
erreicht wurde und es unn¨otig ist, mysql_eof() aufzurufen.
Wenn Sie auf der anderen Seite mysql_use_result() aufrufen, um den Abruf einer Ergeb-
nismenge zu initialisieren, werden die Zeilen des Satzes Zeile f¨ur Zeile vom Server er-
langt, indem Sie mysql_fetch_row() wiederholt aufrufen. Weil w¨ahrend dieses Prozesses
ein Verbindungsfehler auftreten kann, bedeutet ein NULL-R¨uckgabewert von mysql_fetch_
row() nicht notwendigerweise, dass das Ende der Ergebnismenge auf normale Weise erreicht
wurde. In diesem Fall k¨onnen Sie mysql_eof() benutzen, um festzustellen, was passiert ist.
mysql_eof() gibt einen Nicht-0-Wert zur¨uck, wenn das Ende der Ergebnismenge erreicht
wurde, und 0, wenn ein Fehler auftrat.
Historisch liegt mysql_eof() vor den Standard-MySQL-Fehlerfunktionen mysql_errno()
und mysql_error(). Weil diese Fehlerfunktionen dieselben Informationen zur Verf¨ugung
stellen, wird ihre Benutzung des des veralteten mysql_eof() empfohlen. (Sie stellen in der
Tat sogar mehr Informationen zur Verf¨ugung, weil mysql_eof() nur einen Bool’schen Wert
zur¨uckgibt, w¨ahrend die Fehlerfunktionen den Grund angeben, warum der Fehler auftrat.)
R¨uckgabewerte
0, wenn kein Fehler auftrat. Nicht-0, wenn das Ende der Ergebnismenge erreicht wurde.
Comentarios a estos manuales