mysqli_result::__construct

(PHP 5, PHP 7, PHP 8)

mysqli_result::__construct — Construit un objet mysqli_result

Description

public function 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 est occupée et tous les appels suivants retournent 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ées
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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.