(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.9.0)
PDOStatement::fetchColumn — Возвращает данные одного столбца следующей строки результирующего набора
Возвращает данные одного столбца следующей строки результирующей таблицы.
Если в результате запроса строк больше нет, функция вернёт 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 Получение значения первого столбца следующей строки
<?php
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();
print "Получение значения первого столбца первой строки:\n";
$result = $sth->fetchColumn();
print "name = $result\n";
print "Получение значения второго столбца второй строки:\n";
$result = $sth->fetchColumn(1);
print "colour = $result\n";
?>
Результат выполнения приведённого примера:
Получение значения первого столбца первой строки: name = lemon Получение значения второго столбца второй строки: colour = red