mysqli
PHP Manual

mysqli::store_result

mysqli_store_result

(PHP 5)

mysqli::store_result -- mysqli_store_resultTransfiere un conjunto de resulados de la última consulta

Descripción

Estilo orientado a objetos

mysqli_result mysqli::store_result ( void )

Estilo por procedimientos

mysqli_result mysqli_store_result ( mysqli $link )

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

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


mysqli
PHP Manual