« mysqli::thread\_safemysqli::$warning\_count »PHP Manualmysqli

mysqli::use_result

mysqli_use_result

(PHP 5, PHP 7, PHP 8)

mysqli::use_result -- mysqli_use_result — Готує результуючий набір на сервері для використання

Опис

Об'єктно-орієнтований стиль

public mysqli::use_result(): mysqli_result|false

Процедурний стиль

mysqli_use_result(mysqli $mysql): mysqli_result|false

Используется для подготовки к использованию результирующего набора последнего запроса, запущенного функциейmysqli_real_query()

Щоб результати запиту стали доступними, після запиту необхідно викликати або цю функцію, або mysqli_store_result(). Також виклик будь-якому з них запобігатиме відмову наступних запитів на цьому ж з'єднанні.

Зауваження :

mysqli_use_result() не передає весь результуючий набір на клієнта, а отже, неможливо скористатися функцією mysqli_data_seek()для переміщення по ньому. Для цього потрібно скористатися функцією mysqli_store_result(). . mysqli_use_result() не слід використовувати, якщо на стороні клієнта дані результуючого набору довго обробляються, оскільки це затримує роботу сервера і не дає іншим процесам оновлювати таблиці, дані з яких є в результуючому наборі.

Список параметрів

Ця функція не має параметрів.

Значення, що повертаються

Повертає небуферизований об'єкт результату запиту або **false**в случае возникновения ошибки.

Помилки

Якщо сповіщення про помилки mysqli включено (MYSQLI_REPORT_ERROR) та запитана операція не вдалася, видається попередження. Якщо, крім того, встановлено режим MYSQLI_REPORT_STRICT, натомість буде викинуто виняток mysqli_sql_exception

Приклади

Приклад #1 Приклад використання mysqli::use_result()****

Об'єктно-орієнтований стиль

Loading...

Процедурний стиль

Loading...

Результат виконання наведених прикладів:

my_user@localhost
-----------------
Amersfoort
Maastricht
Dordrecht
Leiden
Haarlemmermeer

Дивіться також