- 24.2.3 C-API: Funktionsbeschreibungen
- 24.2.3.1 mysql_affected_rows()
- 24.2.3.2 mysql_autocommit()
- 24.2.3.3 mysql_change_user()
- 24.2.3.4 mysql_character_set_name()
- 24.2.3.5 mysql_close()
- 24.2.3.6 mysql_commit()
- 24.2.3.7 mysql_connect()
- 24.2.3.8 mysql_create_db()
- 24.2.3.9 mysql_data_seek()
- 24.2.3.10 mysql_debug()
- 24.2.3.11 mysql_drop_db()
- 24.2.3.12 mysql_dump_debug_info()
- 24.2.3.13 mysql_eof()
- 24.2.3.14 mysql_errno()
- 24.2.3.15 mysql_error()
- 24.2.3.16 mysql_escape_string()
- 24.2.3.17 mysql_fetch_field()
- 24.2.3.18 mysql_fetch_field_direct()
- 24.2.3.19 mysql_fetch_fields()
- 24.2.3.20 mysql_fetch_lengths()
- 24.2.3.21 mysql_fetch_row()
- 24.2.3.22 mysql_field_count()
- 24.2.3.23 mysql_field_seek()
- 24.2.3.24 mysql_field_tell()
- 24.2.3.25 mysql_free_result()
- 24.2.3.26 mysql_get_character_set_info()
- 24.2.3.27 mysql_get_client_info()
- 24.2.3.28 mysql_get_client_version()
- 24.2.3.29 mysql_get_host_info()
- 24.2.3.30 mysql_get_proto_info()
- 24.2.3.31 mysql_get_server_info()
- 24.2.3.32 mysql_get_server_version()
- 24.2.3.33 mysql_hex_string()
- 24.2.3.34 mysql_info()
- 24.2.3.35 mysql_init()
- 24.2.3.36 mysql_insert_id()
- 24.2.3.37 mysql_kill()
- 24.2.3.38 mysql_library_end()
- 24.2.3.39 mysql_library_init()
- 24.2.3.40 mysql_list_dbs()
- 24.2.3.41 mysql_list_fields()
- 24.2.3.42 mysql_list_processes()
- 24.2.3.43 mysql_list_tables()
- 24.2.3.44 mysql_more_results()
- 24.2.3.45 mysql_next_result()
- 24.2.3.46 mysql_num_fields()
- 24.2.3.47 mysql_num_rows()
- 24.2.3.48 mysql_options()
- 24.2.3.49 mysql_ping()
- 24.2.3.50 mysql_query()
- 24.2.3.51 mysql_real_connect()
- 24.2.3.52 mysql_real_escape_string()
- 24.2.3.53 mysql_real_query()
- 24.2.3.54 mysql_refresh()
- 24.2.3.55 mysql_reload()
- 24.2.3.56 mysql_rollback()
- 24.2.3.57 mysql_row_seek()
- 24.2.3.58 mysql_row_tell()
- 24.2.3.59 mysql_select_db()
- 24.2.3.60 mysql_set_character_set()
- 24.2.3.61 mysql_set_server_option()
- 24.2.3.62 mysql_shutdown()
- 24.2.3.63 mysql_sqlstate()
- 24.2.3.64 mysql_ssl_set()
- 24.2.3.65 mysql_stat()
- 24.2.3.66 mysql_store_result()
- 24.2.3.67 mysql_thread_id()
- 24.2.3.68 mysql_use_result()
- 24.2.3.69 mysql_warning_count()
MYSQL_RES *mysql_use_result(MYSQL *mysql)
Beschreibung
Sie müssen mysql_store_result() oder
mysql_use_result() für jede Anfrage
aufrufen, die erfolgreich Daten abruft
(SELECT, SHOW,
DESCRIBE, EXPLAIN).
mysql_use_result() initiiert den Abruf
einer Ergebnismenge, lädt sie jedoch im Gegensatz zu
mysql_store_result() nicht komplett auf den
Client herunter. Stattdessen wird jede Zeile einzeln mit einem
Aufruf von mysql_fetch_row() abgefragt. So
wird ein Anfrageergebnis direkt vom Server gelesen, ohne es in
einer temporären Tabelle oder in einem lokalen Puffer
zwischenzuspeichern. Das geht schneller und belegt weniger
Speicher als mysql_store_result(). Der
Client weist nur für die aktuelle Zeile Speicher zu und
reserviert einen Kommunikationspuffer, der bis zur Größe von
max_allowed_packet Bytes anwachsen kann.
Demgegenüber sollten Sie
mysql_use_result() nicht verwenden, wenn
Sie jede Zeile auf der Clientseite aufwändig vearbeiten oder
die Ausgabe an einen Bildschirm senden, in den der Benutzer
^S (Stop Scroll) eintippen kann. Dies
würde den Server sperren und verhindern, dass andere Threads
Tabellen aktualisieren können, aus denen die Daten abgerufen
werden.
Wenn Sie mit mysql_use_result() arbeiten,
müssen Sie mysql_fetch_row() so oft
ausführen, bis ein NULL-Wert
zurückgeliefert wird. Sonst werden die nicht abgerufenen
Zeilen zu einem Teil der Ergebnismenge der nächsten Anfrage.
Wenn Sie dies vergessen, meldet die C-API den Fehler
Commands out of sync; you can't run this command
now!
Die Funktionen mysql_data_seek(),
mysql_row_seek(),
mysql_row_tell(),
mysql_num_rows() oder
mysql_affected_rows() können nicht mit
einer Ergebnisrückgabe von
mysql_use_result() benutzt werden. Ebenso
wenig können Sie andere Anfragen absetzen, bevor die Funktion
mysql_use_result() ihre Arbeit beendet hat.
(Immerhin liefert mysql_num_rows() ein
akkurates Ergebnis, wenn Sie alle Zeilen abgeholt haben.)
Sie müssen mysql_free_result() aufrufen,
wenn Sie mit der Ergebnismenge fertig sind.
Bei Verwendung des Embedded Servers
libmysqld geht der Vorteil des geringen
Speicherbedarfs verloren, da die Speicherbelegung inkrementell
mit jeder abgeholten Zeile anwächst, bis Sie
mysql_free_result() aufrufen.
Rückgabewerte
Eine MYSQL_RES-Ergebnisstruktur.
NULL, wenn ein Fehler auftrat.
Fehler
mysql_use_result() setzt bei Erfolg
mysql_error() und
mysql_errno() zurück.
-
CR_COMMANDS_OUT_OF_SYNCBefehle wurden in der falschen Reihenfolge ausgeführt.
-
CR_OUT_OF_MEMORYSpeicherüberlauf.
-
CR_SERVER_GONE_ERRORDer MySQL Server ist nicht mehr verfügbar.
-
CR_SERVER_LOSTDie Serververbindung brach während der Anfrage ab.
-
CR_UNKNOWN_ERROREin 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.
