mysqli_stmt::attr_set

mysqli_stmt_attr_set

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::attr_set -- mysqli_stmt_attr_setModifica el comportamiento de una consulta preparada

Descripción

Estilo orientado a objetos

public mysqli_stmt::attr_set(int $attribute, int $value): bool

Estilo por procedimientos

mysqli_stmt_attr_set(mysqli_stmt $statement, int $attribute, int $value): bool

Modifica el comportamiento de una consulta preparada. Esta función puede ser llamada varias veces para definir múltiples atributos.

Parámetros

stmt

Sólo estilo por procediminetos: Un identificador de declaraciones devuelto por mysqli_stmt_init().

attribute

El atributo que se desea definir. Puede tener uno de los siguientes valores:

Valores de los atributos
Caracteres Descripción
MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH Si se define como true, la función mysqli_stmt_store_result() actualizará el valor de los metadatos MYSQL_FIELD->max_length.
MYSQLI_STMT_ATTR_CURSOR_TYPE Tipo de cursor que permite abrir la consulta cuando se llama a la función mysqli_stmt_execute(). value puede ser MYSQLI_CURSOR_TYPE_NO_CURSOR (por omisión) o MYSQLI_CURSOR_TYPE_READ_ONLY.
MYSQLI_STMT_ATTR_PREFETCH_ROWS Número de filas a recuperar desde el servidor de una sola vez al utilizar un cursor. value puede estar comprendido entre 1 y el valor máximo de un tipo long sin signo. Por omisión, vale 1. Eliminado a partir de PHP 8.4.0.

Si se utiliza la opción MYSQLI_STMT_ATTR_CURSOR_TYPE con MYSQLI_CURSOR_TYPE_READ_ONLY, se abrirá un cursor para la consulta al llamar a la función mysqli_stmt_execute(). Si ya existe un cursor abierto desde una llamada previa a la función mysqli_stmt_execute(), se cerrará antes de abrir uno nuevo. La función mysqli_stmt_reset() cierra asimismo todos los cursores antes de preparar la consulta para una nueva ejecución. La función mysqli_stmt_free_result() cierra cualquier cursor abierto.

Si se abre un cursor para una consulta preparada, la función mysqli_stmt_store_result() no es necesaria.

value

El valor a asignar al atributo.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Errores/Excepciones

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.

add a note

User Contributed Notes 1 note

up
3
chad 0x40 digitellinc 0x2e com
17 years ago
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
To Top