PDOStatement::columnCount
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)
PDOStatement::columnCount — Повертає кількість стовпців у результуючому наборі
Опис
public PDOStatement::columnCount(): int
ИспользуйтеPDOStatement::columnCount(), щоб дізнатися кількість стовпців у результуючому наборі, який представляє об'єкт PDOStatement.
Якщо об'єкт PDOStatement був повернутий з методу PDO::query(), Число стовпців можна дізнатися відразу ж.
Якщо об'єкт PDOStatement був повернутий з методу PDO::prepare()Точну кількість стовпців можна буде дізнатися тільки після запуску методу PDOStatement::execute()
Список параметрів
Ця функція не має параметрів.
Значення, що повертаються
Повертає кількість стовпців у результуючому наборі запиту PDOStatement, навіть якщо він порожній. Якщо результуючого набору немає, PDOStatement::columnCount() повертає
Помилки
Видає помилку рівня E_WARNING, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_WARNING
Викидає виняток PDOException, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_EXCEPTION
Приклади
Приклад #1 Підрахунок стовпців
У цьому прикладі показано, як PDOStatement::columnCount() працює у разі наявності та відсутності результуючого набору.
Результат виконання наведеного прикладу:
Перед вызовом execute(), в результирующем наборе 0 столбцов (должно быть 0)
После вызова execute(), в результирующем наборе 2 столбцов (должно быть 2)
Дивіться також
- PDO::prepare() - готує запит до виконання та повертає пов'язаний із цим запитом об'єкт
- PDOStatement::execute() - Запускає підготовлений запит на виконання
- PDOStatement::rowCount() - Повертає кількість рядків, порушених останнім SQL-запитом