mysqli_stmt::result_metadata
mysqli_stmt_result_metadata
(PHP 5, PHP 7, PHP 8)
mysqli_stmt::result_metadata -- mysqli_stmt_result_metadata — Повертає метадані результуючої таблиці запиту, що готується.
Опис
Об'єктно-орієнтований стиль
public mysqli_stmt::result_metadata(): mysqli_result|false
Процедурний стиль
mysqli_stmt_result_metadata(mysqli_stmt $statement): mysqli_result|false
Якщо запит, переданий у mysqli_prepare(), генерирует результирующую таблицу,mysqli_stmt_result_metadata() повертає об'єкт, за допомогою якого можна отримати опис цього результуючого набору. Зокрема, можна отримати кількість полів та опис кожного окремого поля.
Зауваження :
Отриманий об'єктний покажчик можна передавати як аргумент у функції обробки метаданих результуючих таблиць, як:
Після завершення роботи з цим об'єктом пам'ять, яку він займає, необхідно звільнити. Зробити це можна, передавши об'єктний покажчик на функцію mysqli_free_result()
Зауваження :
Результуючий набір, що повертається з **mysqli_stmt_result_metadata()**містить тільки метадані. У ньому немає рядків вибірки. Результати запиту можна отримати за допомогою функції mysqli_stmt_fetch()
Список параметрів
stmt
Тільки для процедурного стилю: об'єкт mysqli_stmt, який повернула функція mysqli_stmt_init()
Значення, що повертаються
Повертає об'єкт або **false**случае возникновения ошибки.
Помилки
Якщо сповіщення про помилки mysqli включено (MYSQLI_REPORT_ERROR) та запитана операція не вдалася, видається попередження. Якщо, крім того, встановлено режим MYSQLI_REPORT_STRICT, натомість буде викинуто виняток mysqli_sql_exception
Приклади
Приклад #1 Об'єктно-орієнтований стиль
Приклад #2 Процедурний стиль
Дивіться також
- mysqli_prepare() - готує SQL вираз до виконання
- mysqli_free_result() - звільняє пам'ять, зайняту результатами запиту