Forum und email

mysqli_store_result

mysqli->store_result

(PHP 5)

mysqli->store_result — Transfiere un resultado de la última consulta

Descripción

Estilo por procedimientos:

objeto mysqli_store_result ( mysqli_stmt $identificador_de_enlace )

Estilo orientado a objetos (método):

mysqli
objeto store_result ( void )

Transfiere el resultado de la última consulta en la conexión de base de datos representada por el parámetro identificador_de_enlace , para ser usado con la función mysqli_data_seek().

Note: Aunque es siempre una buena practica liberar la memoria usada por el resultado de una consulta usando la función mysqli_free_result(), cuando se transfieren resultados de gran tamaño usando mysqli_store_result() en este caso esta practica se convierte particularmente importante.

Note: mysqli_store_result() regresa FALSE en caso de que la consulta no regrese un resultado (si la consulta fue, por ejemplo una sentencia INSERT). Esta función también regresa FALSE si falla la lectura del resultado. Puede checar si obtuvo un error checando si mysqli_error() no regresa una cadena vacía, si mysqli_errno() regresa un valor diferente de cero o si mysqli_field_count() regresa un valor diferente de cero. También es una razón posible para que esta función regrese FALSE después que una llamada exitosa de mysqli_query() pueda ser demasiado grande el resultado (la memoria no lo puede contener). Si mysqli_field_count() regresa un valor no cero, la sentencia debió producir un resultado no vacío.

Valores retornados

Regresa un objeto resultado con almacenamiento intermedio (buffered) o FALSE si ocurre un error.

Ejemplos

Vea mysqli_multi_query().