- 24.2.7 C-API Prepared Statements: Funktionsbeschreibungen
- 24.2.7.1 mysql_stmt_affected_rows()
- 24.2.7.2 mysql_stmt_attr_get()
- 24.2.7.3 mysql_stmt_attr_set()
- 24.2.7.4 mysql_stmt_bind_param()
- 24.2.7.5 mysql_stmt_bind_result()
- 24.2.7.6 mysql_stmt_close()
- 24.2.7.7 mysql_stmt_data_seek()
- 24.2.7.8 mysql_stmt_errno()
- 24.2.7.9 mysql_stmt_error()
- 24.2.7.10 mysql_stmt_execute()
- 24.2.7.11 mysql_stmt_fetch()
- 24.2.7.12 mysql_stmt_fetch_column()
- 24.2.7.13 mysql_stmt_field_count()
- 24.2.7.14 mysql_stmt_free_result()
- 24.2.7.15 mysql_stmt_init()
- 24.2.7.16 mysql_stmt_insert_id()
- 24.2.7.17 mysql_stmt_num_rows()
- 24.2.7.18 mysql_stmt_param_count()
- 24.2.7.19 mysql_stmt_param_metadata()
- 24.2.7.20 mysql_stmt_prepare()
- 24.2.7.21 mysql_stmt_reset()
- 24.2.7.22 mysql_stmt_result_metadata()
- 24.2.7.23 mysql_stmt_row_seek()
- 24.2.7.24 mysql_stmt_row_tell()
- 24.2.7.25 mysql_stmt_send_long_data()
- 24.2.7.26 mysql_stmt_sqlstate()
- 24.2.7.27 mysql_stmt_store_result()
int mysql_stmt_store_result(MYSQL_STMT
*stmt)
Beschreibung
Sie können mysql_stmt_store_result() für
jede Anweisung aufrufen, die eine Ergebnismenge erstellt
(SELECT, SHOW,
DESCRIBE, EXPLAIN),
sofern Sie die gesamte Ergebnismenge im Client puffern wollen,
damit der nachfolgende
mysql_stmt_fetch()-Aufruf die gepufferten
Daten zurückgibt.
Es ist zwar nicht nötig,
mysql_stmt_store_result() für andere
Anweisungen aufzurufen, aber es schadet auch nichts und hat
keine spürbaren Leistungseinbußen zur Folge. Ob die
Anweisung eine Ergebnismenge erzeugt hat, können Sie
ermitteln, indem Sie nachschauen, ob
mysql_stmt_result_metadata() den Wert
NULL zurückgibt. Weitere Informationen
gibt es unter Abschnitt 24.2.7.22, „mysql_stmt_result_metadata()“.
Hinweis: MySQL berechnet nach
Voreinstellung nicht die
MYSQL_FIELD->max_length für alle
Spalten in mysql_stmt_store_result(), da
dieser Rechenaufwand
mysql_stmt_store_result() deutlich
verlangsamen würde und die meisten Anwendungen auf
max_length gut verzichten können. Wenn Sie
max_length aktualisieren möchten, können
Sie dies mit mysql_stmt_attr_set(MYSQL_STMT,
STMT_ATTR_UPDATE_MAX_LENGTH, &flag)
ermöglichen. Siehe Abschnitt 24.2.7.3, „mysql_stmt_attr_set()“.
Rückgabewerte
Null, wenn die Ergebnisse erfolgreich gepuffert wurden, und ein von null verschiedener Wert, wenn ein Fehler auftrat.
Fehler
-
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.
