- 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()
MYSQL_RES *mysql_stmt_result_metadata(MYSQL_STMT
*stmt)
Beschreibung
Wenn an mysql_stmt_prepare() eine Anweisung
übergeben wird, die eine Ergebnismenge produziert, liefert
mysql_stmt_result_metadata() die Metadaten
zu dieser Ergebnismenge in Form eines Zeigers auf eine
MYSQL_RES-Struktur, die genutzt werden
kann, um solche Daten wie etwa die Gesamtzahl der Felder und
Informationen über einzelne Felder zu verarbeiten. Dieser
Ergebnismengenzeiger kann als Argument an API-Feldfunktionen
übergeben werden, die Metadaten von Ergebnismengen
verarbeiten, wie zum Beispiel:
mysql_num_fields()mysql_fetch_field()mysql_fetch_field_direct()mysql_fetch_fields()mysql_field_count()mysql_field_seek()mysql_field_tell()mysql_free_result()
Die Ergebnismengenstruktur sollte nach Abschluss der
Verarbeitung freigegeben werden, indem man sie an
mysql_free_result() übergibt. Auf dieselbe
Weise wird eine Ergebnismenge aus einem
mysql_store_result()-Aufruf freigegeben.
Die von mysql_stmt_result_metadata()
zurückgegebene Ergebnismenge enthält nur Metadaten und keine
Ergebniszeilen. Diese rufen Sie ab, indem Sie den
Anweisungs-Handle in Verbindung mit
mysql_stmt_fetch() benutzen.
Rückgabewerte
Eine MYSQL_RES-Ergebnisstruktur oder
NULL, wenn keine Metainformationen über
die vorbereitete Anfrage existieren.
Fehler
-
CR_OUT_OF_MEMORYSpeicherüberlauf.
-
CR_UNKNOWN_ERROREin unbekannter Fehler ist aufgetreten.
Beispiel
Die Benutzung von
mysql_stmt_result_metadata() wird aus dem
Beispiel von Abschnitt 24.2.7.11, „mysql_stmt_fetch()“, ersichtlich.
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.
