ЛИНТЕР

Получить заданную строку результирующей выборки

Назначение

Предоставление заданной строки результирующей выборки.

Синтаксические правила

mixed PDOStatement::fetch ([int fetch_style[, int cursor_orientation[, int cursor_offset]]]);

fetch_style

Режим выборки данных (одна из констант вида PDO::FETCH_*). Допустимые значения см. в пункте «Установить режим выборки данных». По умолчанию используется режим PDO::FETCH_BOTH.

cursor_orientation

Константа, определяющая возвращаемую строку результирующей выборки.

Константа		Возвращаемая строка
`PDO::FETCH_ORI_NEXT`		Следующая строка по отношению к текущей строке
`PDO::FETCH_ORI_PRIOR`		Предыдущая строка по отношению к текущей строке
`PDO::FETCH_ORI_FIRST`		Первая строка выборки
`PDO::FETCH_ORI_LAST`		Последняя строка выборки
`PDO::FETCH_ORI_ABS`		Строка с указанным в аргументе `offset` порядковым номером. Отсчет строк выборки начинается c 1
`PDO::FETCH_ORI_REL`		Строка со смещением, задаваемым в аргументе `offset`, по отношению к текущей строке выборки. Если значение `offset` положительное, строка выбирается из последующих строк выборки, если отрицательное – из предыдущих

Во всех случаях, когда результирующая выборка пуста или задаваемая строка выборки не существует, возвращается NULL.

Если номер выбираемой строки не задан, по умолчанию используется PDO::FETCH_ORI_NEXT.

offset

Абсолютный или относительный номер выбираемой строки (см. PDO::FETCH_ORI_ABS, PDO::FETCH_ORI_REL).

Описание

Функция возвращает запрашиваемую строку результирующей выборки (если она существует). PDOStatement-объект, соответствующий данной выборке, должен быть скролируемым курсором (т.е. должен быть установлен атрибут PDO::CURSOR_SCROLL при подготовке к выполнению поискового SQL-оператора с помощью функции PDO::prepare()).

Возвращаемые значения

true – запрошенная строка предоставлена;
false – запрошенная строка не найдена.

Пример

<?php
…
  $sql = "SELECT 'Иванов'
          union
          SELECT 'Петров'
          union
          SELECT 'Сидоров'
          union
          SELECT 'Смирнов'";
  $stmt = $dbh->prepare($sql);
  $stmt->execute();
  $row = $stmt->fetch(PDO::FETCH_NUM,PDO::FETCH_ORI_ABS,3);
  print $row[0]."\n";
}
?>

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

Сидоров