ЛИНТЕР

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

Назначение

Установка режима выборки данных для поискового 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