Transfiere un conjunto de resultados desde la última consulta

# mysqli::store_result

# mysqli_store_result

(PHP 5, PHP 7, PHP 8)

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

### Descripción

Estilo orientado a objetos

public function mysqli::store_result(int `$mode` = 0): mysqli_result|false

Estilo procedimental

function mysqli_store_result(mysqli `$mysql`, int `$mode` = 0): mysqli_result|false

Transfiere el conjunto de resultados desde la última consulta en la conexión a la base de datos especificada por el argumento `mysql` para su uso con mysqli_data_seek().

### Parámetros

`mysql`
  Solo estilo procedimental: Un objeto mysqli devuelto por mysqli_connect() o mysqli_init()
`mode`

  La opción que se desea definir. A partir de PHP 8.1, este argumento no tiene ningún efecto. Puede tomar uno de los siguientes valores:

  Opciones válidas
  Nombre | Descripción
  --- | ---
  `MYSQLI_STORE_RESULT_COPY_DATA` | Copia los resultados recuperados de un buffer interno mysqlnd a variables PHP. Por omisión, mysqlnd utilizará una referencia lógica para evitar la copia y la duplicación de los resultados contenidos en memoria. Para ciertos conjuntos de resultados, por ejemplo, los conjuntos de resultados con muchas filas pequeñas, el enfoque de copia puede reducir el uso de memoria por las variables PHP que contienen los resultados pueden ser liberadas rápidamente (disponible únicamente con mysqlnd)

### Valores devueltos

Retorna un resultado almacenado en forma de objeto o `false` si ocurre un error.

> Nota:

> mysqli_store_result() retorna `false` en caso de que la consulta no retorne un conjunto de resultados (si la consulta es de tipo INSERT por ejemplo). Esta función retornará siempre `false` si el conjunto de resultados no puede ser leído. Se puede saber si hay un error utilizando la función mysqli_error() y mirando si retorna un string vacío, o si mysqli_errno() retorna cero, o bien si mysqli_field_count() retorna un valor diferente de cero. Otra razón para que esta función retorne `false` es que el conjunto de resultados retornado después de una consulta exitosa llamada por mysqli_query() es demasiado largo (la memoria para este no puede ser asignada). Si mysqli_field_count() retorna un valor diferente de cero, el procesamiento debería producir un conjunto de resultados no vacío.

### Errores/Excepciones

Si el informe de errores de mysqli está habilitado (`MYSQLI_REPORT_ERROR`) y la operación solicitada falla, se genera una advertencia. Si, además, el modo está configurado como `MYSQLI_REPORT_STRICT`, se lanza una mysqli_sql_exception en su lugar.

### Historial de cambios

Versión | Descripción
--- | ---
8.4.0 | El paso del argumento `mode` está ahora obsoleto. Este argumento no ha tenido ningún efecto desde PHP 8.1.0.

### Ejemplos

Ver la función mysqli_multi_query().

### Notas

> Nota:

> Siempre se recomienda liberar la memoria asignada para el resultado utilizando la función mysqli_free_result(), al transferir grandes resultados utilizando la función mysqli_store_result() esto se vuelve particularmente importante.

### Ver también

- mysqli_real_query() - Ejecuta una consulta SQL
- mysqli_use_result() - Inicializa la recuperación de un conjunto de resultados

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open