# mysqli::store_result

# mysqli_store_result

(PHP 5, PHP 7, PHP 8)

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

### Descripción

Estilo orientado a objetos

mysqli::store_result(int `$option` = ?): mysqli_result

Estilo por procedimientos

mysqli_store_result(mysqli `$link`, int `$option` = ?): mysqli_result

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 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 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() devuelve 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_real_query() - Ejecuta una consulta SQL
- mysqli_use_result() - Inicia la recuperación de un conjunto de resultados