This is basically a wrapper for mysql_stmt_attr_set in the MySQL C API: http://dev.mysql.com/doc/refman/5.0/en/mysql-stmt-attr-set.html
(PHP 5, PHP 7, PHP 8)
mysqli_stmt::attr_set -- mysqli_stmt_attr_set — Verändert das Verhalten einer vorbereiteten Anweisung (prepared statement)
Objektorientierter Stil
Prozeduraler Stil
Wird verwendet, um das Verhalten einer vorbereiteten Anweisung (prepared statement) zu verändern. Die Funktion kann mehrmals aufgerufen werden, um verschiedene Attribute zu setzen.
statement
Nur bei prozeduralem Aufruf: ein von mysqli_stmt_init() zurückgegebenes mysqli_stmt-Objekt.
attribute
Das Attribut, das gesetzt werden soll. Es kann einen der folgenden Werte haben:
Konstante | Beschreibung |
---|---|
MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH |
Der Wert true veranlasst
mysqli_stmt_store_result(), die
Meta-Information MYSQL_FIELD->max_length zu
aktualisieren.
|
MYSQLI_STMT_ATTR_CURSOR_TYPE |
Der Typ des Cursors, der für die Anweisung geöffnet wird, wenn
mysqli_stmt_execute() aufgerufen wird.
value kann
MYSQLI_CURSOR_TYPE_NO_CURSOR (Voreinstellung)
oder MYSQLI_CURSOR_TYPE_READ_ONLY sein.
|
MYSQLI_STMT_ATTR_PREFETCH_ROWS |
Die Anzahl der Datensätze, die auf einmal vom Server abgerufen
werden, wenn ein Cursor verwendet wird.
value kann zwischen 1 und dem Maximalwert
von unsigned long (einschließlich) liegen. Die Voreinstellung ist
1.
|
Wenn die Option MYSQLI_STMT_ATTR_CURSOR_TYPE
mit
MYSQLI_CURSOR_TYPE_READ_ONLY
verwendet wird, dann
wird ein Cursor für die Anweisung geöffnet, sobald
mysqli_stmt_execute() aufgerufen wird. Wenn es schon
einen offenen Cursor von einem vorherigen Aufruf von
mysqli_stmt_execute() gibt, dann wird der Cursor
geschlossen, bevor der neue geöffnet wird.
mysqli_stmt_reset() schließt ebenfalls alle offenen
Cursor, bevor die Anweisung für die Wiederausführung vorbereitet wird.
mysqli_stmt_free_result() schließt alle offenen
Cursor.
Wenn ein Cursor für eine Anweisung geöffnet wird, dann ist mysqli_stmt_store_result() unnötig.
value
Der Wert, der dem Attribut zugewiesen werden soll.
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.
If mysqli error reporting is enabled (MYSQLI_REPORT_ERROR
) and the requested operation fails,
a warning is generated. If, in addition, the mode is set to MYSQLI_REPORT_STRICT
,
a mysqli_sql_exception is thrown instead.
This is basically a wrapper for mysql_stmt_attr_set in the MySQL C API: http://dev.mysql.com/doc/refman/5.0/en/mysql-stmt-attr-set.html