(PHP 5, PHP 7, PHP 8)
mysqli_result::__construct — Construit un objet mysqli_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().
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.
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.
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.