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

Назначение
 

Функция DB_Result::fetchRow() предоставляет заданную строку результирующей выборки.

Синтаксические правила
mixed fetchRow ([integer $fetchmode[, integer $rownum]]);
$fetchmode

Формат выбираемых строк. По умолчанию DB_FETCHMODE_DEFAULT.

$rownum

Номер строки для выборки. По умолчанию NULL.

Описание

DB_Result содержит результат выполнения запроса к БД. Ссылка на экземпляр объекта DB_Result возвращается функциями query() или execute().

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

Результаты обработки запроса:

  • mixed – массив значений строки в случае успешного выполнения запроса;

  • NULL – если заданная строка не найдена;

  • DB_Error-объект – в случае ошибки при выполнении запроса.

Примеры
  1. while ($row = $result-​>fetchRow()) {
       // По умолчанию поведение метода fetchRow() – это возвращение
       // ассоциативного массива, такого как:
       // $row = array (
       //0 =​> <​first column data​>,
       //1 =​> <​second column data​>
       //);
       echo $row[0]."<​br​>\n";
    }
    ?​>
  2. $row = $db-​>getRow("select year, model from auto where personid=100", DB_FETCHMODE_OBJECT);
    print_r($row);
    // Пусть типом класса по умолчанию объекта «строка» будет
    db_row Object
    (
    [year] =​> 70
    [model] =​> BMW
    [color] =​> BLACK
    )
    Доступ к  данным объекта:
    $year = $row-​>year;
    $model = $row-​>model;
    $color = $row-​>color;

Возможны два метода доступа.

// первый метод:
while ($row = $result-​>fetchRow(DB_FETCHMODE_ASSOC))
{
   // $row = array(
   //'year' =​> <​данные столбца year​>,
   //'model' =​> <​данные столбца model​>
   //'color' =​> <​данные столбца color​>
   //);
   $id = row['id'];
}
// Второй метод (используется по умолчанию)
$db-​>setfetchmode(DB_FETCHMODE_ASSOC);
// устанавливаем метод по умолчанию
$result-​>query($sql);
while ($row = $result-​>fetchRow())
{
   $year = row['year'];
   $model = row['model'];
   $color = row['color'];
}