mysqli::store_result

mysqli_store_result

(PHP 5)

mysqli::store_result -- mysqli_store_result — Transfiere un conjunto de resulados de la última consulta

Descripción

Estilo orientado a objetos

mysqli_result mysqli::store_result ([ int $option ] )

Estilo por procedimientos

mysqli_result mysqli_store_result ([ int $option ] )

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().

Parámetros

link

Sólo estilo por procediminetos: Un identificador de enlace devuelto por mysqli_connect() o mysqli_init()

option

La opción a establecer. Puede ser uno de los siguientes valores:
Opciones válidas
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)

Valores devueltos

Devuelve un objeto de resultados almacenado en buffer o FALSE si ocurrió un error.

Nota:

mysqli_store_result() devuelve FALSE en 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 devuelve FALSE si la lectura del conjunto de resultados falla. Se puede coprobar 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 devuelva FALSE despué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() deveulve un valor distinto de cero, la sentencia debería haber producido un conjunto de resultados no vacío.

Notas

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.

Ejemplos

Véase mysqli_multi_query().

Ver también