(PHP 5, PHP 7, PHP 8)
mysqli::store_result -- mysqli_store_result — Transfiere un conjunto de resultados desde la última consulta
Estilo orientado a objetos
Estilo por procedimientos
Transfiere el conjunto de resultados desde la última consulta en la conexión
a la base de datos especificada por el argumento mysql
para su uso con mysqli_data_seek().
link
Sólo estilo por procediminetos: Un identificador de enlace devuelto por mysqli_connect() o mysqli_init()
mode
La opción que se desea definir. A partir de PHP 8.1, este argumento no tiene ningún efecto. Puede tomar uno de los siguientes valores:
Nombre | Descripción |
---|---|
MYSQLI_STORE_RESULT_COPY_DATA |
Copia los resultados recuperados de un buffer interno mysqlnd a variables PHP. Por omisión, mysqlnd utilizará una referencia lógica para evitar la copia y la duplicación de los resultados contenidos en memoria. Para ciertos conjuntos de resultados, por ejemplo, los conjuntos de resultados con muchas filas pequeñas, el enfoque de copia puede reducir el uso de memoria por las variables PHP que contienen los resultados pueden ser liberadas rápidamente (disponible únicamente con mysqlnd) |
Retorna un resultado almacenado en forma de objeto o false
si ocurre un error.
Nota:
mysqli_store_result() retorna
false
en caso de que la consulta no retorne un conjunto de resultados (si la consulta es de tipo INSERT por ejemplo). Esta función retornará siemprefalse
si el conjunto de resultados no puede ser leído. Se puede saber si hay un error utilizando la función mysqli_error() y mirando si retorna un string vacío, o si mysqli_errno() retorna cero, o bien si mysqli_field_count() retorna un valor diferente de cero. Otra razón para que esta función retornefalse
es que el conjunto de resultados retornado después de una consulta exitosa llamada por mysqli_query() es demasiado largo (la memoria para este no puede ser asignada). Si mysqli_field_count() retorna un valor diferente de cero, el procesamiento debería producir un conjunto de resultados no vacío.
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.
Versión | Descripción |
---|---|
8.4.0 |
El paso del argumento mode está ahora obsoleto.
Este argumento no ha tenido ningún efecto desde PHP 8.1.0.
|
Ver la función mysqli_multi_query().
Nota:
Siempre se recomienda liberar la memoria asignada para el resultado utilizando la función mysqli_free_result(), al transferir grandes resultados utilizando la función mysqli_store_result() esto se vuelve particularmente importante.