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

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

Назначение

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

Синтаксические правила
 
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";
}
?> 

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

Сидоров
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter