Получить заданную строку результирующей выборки
Назначение
Предоставление заданной строки результирующей выборки.
Синтаксические правила
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 1PDO::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"; } ? >
Результат выполнения данного примера:
Сидоров