# mysqli_result::__construct

(PHP 5, PHP 7, PHP 8)

mysqli_result::__construct — Construit un objet mysqli_result

### Description

public mysqli_result::__construct(mysqli `$mysql`, int `$result_mode` = `MYSQLI_STORE_RESULT`)

Cette méthode construit un nouvel objet mysqli_result.

Ceci peut être utilisé pour créer l'objet mysqli_result après avoir appelé les fonctions mysqli_real_query() ou mysqli_multi_query(). Construire l'objet manuellement est équivalent à appeler les fonctions mysqli_store_result() ou mysqli_use_result().

### Liste de paramètres

`mysql`

  Seulement en style procédural : Un objet mysqli retourné par la fonction mysqli_connect() ou mysqli_init().

`result_mode`

  Le mode de résultat peut être une des 2 constantes indiquant comment le résultat sera retourné par le serveur MySQL.

  `MYSQLI_STORE_RESULT` (défaut) - créer un objet mysqli_result avec un jeu de résultats tamponné.

  `MYSQLI_USE_RESULT` - créer un objet mysqli_result avec un jeu de résultats non-tamponné. Tant qu'il reste des enregistrements en attente d'être récupérés, la ligne de connexion sera occupée et tous les appels suivants retourneront l'erreur `Commands out of sync`. Pour éviter l'erreur, tous les enregistrements doivent être récupérés du serveur ou le jeu de résultats doit être jeté en appelant mysqli_free_result(). La connexion doit rester ouverte pour que les lignes soient récupérées.

### Erreurs / Exceptions

Si le rapport d'erreurs mysqli est activé (`MYSQLI_REPORT_ERROR`) et que l'opération demandée échoue, un avertissement est généré. Si, en plus, le mode est défini sur `MYSQLI_REPORT_STRICT`, une mysqli_sql_exception est lancée à la place.

### Exemples

Exemple #1 Création d'un objet mysqli_result

`<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Requête SELECT retournant un jeu de résultats */
$mysqli->real_query("SELECT Name FROM City LIMIT 10");
$result = new mysqli_result($mysqli);
printf("Select returned %d rows.\n", $result->num_rows);`

Les exemples ci-dessus vont afficher quelque chose de similaire à :

    Select returned 10 rows.

### Voir aussi

- mysqli_multi_query() - Exécute une ou plusieurs requêtes sur la base de donnée
- mysqli_real_query() - Exécute une requête SQL
- mysqli_store_result() - Transfère un jeu de résultats à partir de la dernière requête
- mysqli_use_result() - Initialise la récupération d'un jeu de résultats