- 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()
my_bool mysql_stmt_bind_param(MYSQL_STMT *stmt,
MYSQL_BIND *bind)
Beschreibung
Die Funktion mysql_stmt_bind_param() bindet
Daten an die Parametermarker in der SQL-Anweisung, die an
mysql_stmt_prepare() übergeben wurde. Zur
Übergabe der Daten verwendet sie
MYSQL_BIND-Strukturen.
bind ist die Adresse eines Arrays von
MYSQL_BIND-Strukturen. Die Clientbibliothek
erwartet, dass das Array für jeden
‘?’-Parametermarker in der
Anfrage einen Wert enthält.
Angenommen, Sie bereiten folgende Anweisung vor:
INSERT INTO mytbl VALUES(?,?,?)
Wenn Sie die Parameter binden, muss das Array von
MYSQL_BIND-Strukturen drei Elemente
enthalten. Es kann wie folgt deklariert werden:
MYSQL_BIND bind[3];
Die Bestandteile jedes MYSQL_BIND-Elements,
das gesetzt werden muss, sind in
Abschnitt 24.2.5, „C-API: Prepared Statement-Datentypen“,
beschrieben.
Rückgabewerte
Null, wenn das Binden erfolgreich verlief. Ein von null verschiedener Wert, wenn ein Fehler auftrat.
Fehler
-
CR_INVALID_BUFFER_USEZeigt an, ob lange Daten beim Binden stückweise an einen Puffer übergeben werden, der kein String- oder Binärpuffer ist.
-
CR_UNSUPPORTED_PARAM_TYPEDie Konvertierung wird nicht unterstützt. Eventuell ist der
buffer_type-Wert unzulässig oder hat keinen der unterstützten Typen. -
CR_OUT_OF_MEMORYSpeicherüberlauf.
-
CR_UNKNOWN_ERROREin unbekannter Fehler ist aufgetreten.
Beispiel
Wie man mysql_stmt_bind_param() verwendet,
sehen Sie im Beispiel von
Abschnitt 24.2.7.10, „mysql_stmt_execute()“.
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.
