(PHP 5, PHP 7)
mysqli::store_result -- mysqli_store_result — Transfiere un conjunto de resultados de la última consulta
Estilo orientado a objetos
Estilo por procedimientos
Transfiere el conjunto de resultados de la última consulta de la conexión a la base de datos
representada por el parámetro link a ser usado con
la función mysqli_data_seek().
linkSólo estilo por procediminetos: Un identificador de enlace devuelto por mysqli_connect() o mysqli_init()
optionLa opción a establecer. Puede ser uno de los siguientes valores:
| Nombre | Descripción |
|---|---|
MYSQLI_STORE_RESULT_COPY_DATA |
Copiar los resultados desde el búfer interno de mysqlnd a variables de PHP. Por defecto, mysqlnd usará un lógica de referencia para evitar copiar y duplicar resultados contenidos en memoria. Para ciertos conjuntos de resultados con filas muy pequeñas, por ejemplo, la estrategia de copia puede reducir el uso total de memoria debido a que las variables de PHP de contienen resultados podrían ser liberadas antes (disponible con mysqlnd solamente, desde PHP 5.6.0) |
Devuelve un objeto de resultados almacenado en buffer o FALSE si ocurrió un error.
Nota:
mysqli_store_result() devuelve
FALSEen caso de que la consulta no devuelve un conjunto de resultados (si la consulta era, por ejemplo, una sentencia INSERT). Esta función también devuelveFALSEsi la lectura del conjunto de resultados falla. Se puede comprobar si se ha obtenido un error comprobando si mysqli_error() no devuelve una cadena vacía, si mysqli_errno() devuelve un valor distinto de cero, o si mysqli_field_count() devuelve un valor distinto de cero. Otra posible razón para que esta función devuelvaFALSEdespués de una llamada con éxito a mysqli_query() puede ser un conjunto de resultados demasiado grande (no es posible asignarle memoria). Si mysqli_field_count() devuelve un valor distinto de cero, la sentencia debería haber producido un conjunto de resultados no vacío.
Nota:
Aunque es una buena práctica liberar la memoria usada por los resultados de una consulta usando la función mysqli_free_result(), al transferir conjuntos de resultados grandes usando la función mysqli_store_result() esto se convierte en particularmente importante.
Véase mysqli_multi_query().