- 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_store_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,
CHECK TABLE, und so weiter).
Für andere Anfragen brauchen Sie
mysql_store_result() oder
mysql_use_result() nicht zu verwenden, aber
es schadet auch nichts und bringt keine spürbaren
Leistungseinbußen, wenn Sie in jedem Fall
mysql_store_result() aufrufen. Sie können
erkennen, ob die Anfrage eine Ergebnismenge hatte oder nicht,
indem Sie prüfen, ob mysql_store_result()
0 zurückgibt (darüber später mehr).
Wenn Sie wissen möchten, ob die Anfrage eine Ergebnismenge
zurückgeben müsste, prüfen Sie dies mit
mysql_field_count(). Siehe
Abschnitt 24.2.3.22, „mysql_field_count()“.
mysql_store_result() liest das gesamte
Anfrageergebnis auf den Client ein, weist eine
MYSQL_RES-Struktur zu und setzt das
Resultat in diese Struktur ein.
mysql_store_result() liefert einen
Nullzeiger, wenn die Anfrage keine Ergebnismenge zurückgab
(also beispielsweise eine INSERT-Anweisung
war).
mysql_store_result() liefert auch einen
Nullzeiger, wenn die Ergebnismenge nicht gelesen werden
konnte. Ein Fehler ist aufgetreten, wenn
mysql_error() einen nichtleeren String oder
einen von null verschiedenen Wert liefert oder wenn
mysql_field_count() null zurückgibt.
Eine leere Ergebnismenge bedeutet, dass keine Zeilen zurückgegeben wurden. (Eine leere Ergebnismenge ist etwas anderes als ein Nullzeiger als Rückgabewert.)
Wenn Sie mysql_store_result() aufgerufen
und ein Ergebnis erhalten haben, das kein Nullzeiger ist,
können Sie mit mysql_num_rows() ermitteln,
wie viele Zeilen die Ergebnismenge hat.
Sie können mit mysql_fetch_row() Zeilen
aus der Ergebnismenge abrufen oder mit
mysql_row_seek() und
mysql_row_tell() die aktuelle
Zeilenposition in der Ergebnismenge ermitteln oder einstellen.
Wenn Sie mit der Ergebnismenge fertig sind, rufen Sie
mysql_free_result() auf.
Rückgabewerte
Eine MYSQL_RES-Ergebnisstruktur mit den
Resultaten. NULL, wenn ein Fehler auftrat.
Fehler
Die Funktion mysql_store_result() setzt
mysql_error() und
mysql_errno() zurück, wenn sie erfolgreich
gelaufen ist.
-
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.
