Доступные версии документации

Установить режим выборки данных

Назначение

Установка режима выборки данных для поискового SQL-оператора.

Синтаксические правила
 
bool PDOStatement::setFetchMode (int mode);
mode

Константа, соответствующая определенному режиму извлечения данных.

Константа Режим выборки данных
PDO::FETCH_LAZY Каждая строка выборки должна быть представлена в виде объекта, содержащего набор переменных, имена которых совпадают с именами столбцов результирующей выборки
PDO::FETCH_ASSOC Каждая строка выборки должна быть представлена в виде массива, индексируемого по именам столбцов результирующей выборки. Если строка ответа содержит дубликаты столбцов, возвращается только одно значение для этого имени столбца
PDO::FETCH_NAMED Каждая строка выборки должна быть представлена в виде массива, индексируемого по именам столбцов результирующей выборки. Если строка ответа содержит дубликаты столбцов, возвращается массив их значений
PDO::FETCH_NUM Каждая строка выборки должна быть представлена в виде массива, индексируемого по номерам столбцов результирующей выборки. Нумерация столбцов начинается с 0
PDO::FETCH_BOTH Каждая строка выборки должна быть представлена в виде массива, индексируемого по имени и номеру столбца результирующей выборки. Нумерация столбцов начинается с 0
PDO::FETCH_OBJ Каждая строка выборки должна быть представлена в виде объекта, содержащего свойства, имена которых соответствуют именам столбцов результирующей выборки
PDO::FETCH_BOUND Значения столбцов результирующей выборки должны присваиваться переменным, привязанным к оператору с помощью функции PDOStatement::bindParam() or PDOStatement::bindColumn(). Данный режим выборки должен всегда возвращать true
PDO::FETCH_COLUMN  Должно возвращаться только одно значение указанного столбца результирующей выборки
PDO::FETCH_CLASS  Должен возвращаться новый экземпляр заданного класса, отображающий столбцы в именованные свойства этого класса
PDO::FETCH_INTO  Должен возвращаться существующий обновленный экземпляр заданного класса, отображающий столбцы в именованные свойства этого класса
PDO::FETCH_FUNC  Каждая строка выборки должна передаваться на обработку пользовательской функции
PDO::FETCH_GROUP  Должен возвращаться ассоциированный массив, содержащий значения заданной группы столбцов результирующей выборки. Для задания группы столбцов должна использоваться битовая маска флага PDO::FETCH_COLUMN совместно с флагом данного режима
PDO::FETCH_UNIQUE  Должен возвращаться ассоциированный массив, содержащий уникальные значения заданной группы столбцов результирующей выборки. Для задания группы столбцов должна использоваться битовая маска флага PDO::FETCH_COLUMN совместно с флагом данного режима
PDO::FETCH_CLASSTYPE  Имя класса определяется по значению первого столбца результирующей выборки. Используется совместно с режимом PDO::FETCH_CLASS, т.е. PDO::FETCH_CLASS | PDO::FETCH_CLASSTYPE
Возвращаемые значения
  • 1 – нормальное завершение;

  • false – ошибка установки режима выборки.

Пример
<?php
…
$sql = 'SELECT make, model, color FROM auto fetch first 3';
try {
  $stmt = $dbh->query($sql);
  $result = $stmt->setFetchMode(PDO::FETCH_NUM);
  while ($row = $stmt->fetch()) {
    print $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n";
  }
}
catch (PDOException $e) {
  print $e->getMessage();
}
?>

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

FORD                MERCURY COMET GT V8 BLACK
ALPINE              A-310               WHITE
AMERICAN MOTORS     MATADOR STATION     BROWN
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter