PDOStatement::fetchColumn

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.9.0)

PDOStatement::fetchColumn — Повертає дані одного стовпця наступного рядка результуючого набору

Опис

public PDOStatement::fetchColumn(int $column = 0): mixed

Повертає дані одного стовпця наступного рядка результуючої таблиці. Якщо в результаті запиту рядків більше немає, функція поверне false

Зауваження :

Не слід використовувати PDOStatement::fetchColumn() для отримання логічних полів, тому що неможливо відрізнити значення false від відсутності рядків результату, що залишилися. Натомість використовуйте метод PDOStatement::fetch()

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

column

Номер стовпця, дані якого потрібно витягти. Нумерація починається з 0. Якщо параметр не встановлено, PDOStatement::fetchColumn() обере дані першого стовпця.

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

МетодPDOStatement::fetchColumn() повертає значення одного стовпця наступного рядка результуючого набору або **false**якщо більше немає рядків.

Увага

При виклику методу PDOStatement::fetchColumn() для отримання даних з результуючого набору неможливо отримати значення іншого стовпця того ж рядка.

Помилки

Видає помилку рівня E_WARNING, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_WARNING

Викидає виняток PDOException, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_EXCEPTION

Приклади

Приклад #1 Отримання значення першого стовпця наступного рядка

Loading...
▶

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

Получение значения первого столбца первой строки:
name = lemon
Получение значения второго столбца второй строки:
colour = red

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

• PDO::query() - готує та виконує вираз SQL без заповнювачів
• PDOStatement::fetch() - Вилучення наступного рядка з результуючого набору
• PDOStatement::fetchAll() - Вибирає рядки, що залишилися, з набору результатів
• PDO::prepare() - готує запит до виконання та повертає пов'язаний із цим запитом об'єкт
• PDOStatement::setFetchMode() - Встановлює режим вибірки за промовчанням для об'єкта запиту