CDbDataReader

foreach($reader as $row)
    // $row represents a row of data

Подробное описание свойств

columnCount свойство только для чтения

public integer getColumnCount()

Возвращает количество столбцов в наборе результатов. Обратите внимание, даже если в читателе нет строк, это всё равно даёт правильное количество столбцов.

isClosed свойство только для чтения

public boolean getIsClosed()

является ли читатель закрытым или нет.

rowCount свойство только для чтения

public integer getRowCount()

Возвращает количество строк в наборе результатов. Обратите внимание, что многие СУБД могут не предоставить осмысленного счётчика. В этом случае используйте «SELECT COUNT(*) FROM tableName», чтобы получить количество строк.

Подробное описание методов

__construct() метод

public void __construct(CDbCommand $command)

public function __construct(CDbCommand $command)
{
    $this->_statement=$command->getPdoStatement();
    $this->_statement->setFetchMode(PDO::FETCH_ASSOC);
}

Конструктор.

bindColumn() метод

public void bindColumn(mixed $column, mixed &$value, integer $dataType=NULL)

public function bindColumn($column, &$value, $dataType=null)
{
    if($dataType===null)
        $this->_statement->bindColumn($column,$value);
    else
        $this->_statement->bindColumn($column,$value,$dataType);
}

Привязывает столбец к PHP переменной. При извлечении строк данных соответствующее значение столбца будет установлено в переменной. Обратите внимание, что режим извлечения должен включать PDO::FETCH_BOUND.

close() метод

public void close()

public function close()
{
    $this->_statement->closeCursor();
    $this->_closed=true;
}

Закрывает reader. Это освобождает ресурсы, выделенные для выполнения данного SQL запроса. Попытки чтения после вызова этого метода могут иметь непредсказуемый результат.

count() метод

public integer count()

public function count()
{
    return $this->getRowCount();
}

Возвращает количество строк в наборе результатов. Этот метод необходим для интерфейса Countable. Обратите внимание, что большинство СУБД могут не предоставить осмысленное значение подсчёта. В этом случае используйте «SELECT COUNT(*) FROM tableName» для получения количества строк.

current() метод

public mixed current()

public function current()
{
    return $this->_row;
}

Возвращает текущую строку. Этот метод требуется для интерфейса Iterator.

getColumnCount() метод

public integer getColumnCount()

public function getColumnCount()
{
    return $this->_statement->columnCount();
}

Возвращает количество столбцов в наборе результатов. Обратите внимание, что даже если в reader нет строк, это всё равно даёт правильное количество столбцов.

getIsClosed() метод

public boolean getIsClosed()

public function getIsClosed()
{
    return $this->_closed;
}

закрыт ли reader или нет.

getRowCount() метод

public integer getRowCount()

public function getRowCount()
{
    return $this->_statement->rowCount();
}

Возвращает количество строк в наборе результатов. Обратите внимание, что большинство СУБД могут не предоставить осмысленное значение подсчёта. В этом случае используйте «SELECT COUNT(*) FROM tableName» для получения количества строк.

key() метод

public integer key()

public function key()
{
    return $this->_index;
}

Возвращает индекс текущей строки. Этот метод требуется для интерфейса Iterator.

next() метод

public void next()

public function next()
{
    $this->_row=$this->_statement->fetch();
    $this->_index++;
}

Перемещает внутренний указатель к следующей строке. Этот метод требуется для интерфейса Iterator.

nextResult() метод

public boolean nextResult()

public function nextResult()
{
    if(($result=$this->_statement->nextRowset())!==false)
        $this->_index=-1;
    return $result;
}

Перемещает reader к следующему результату при чтении результатов набора заявок. Этот метод полезен только в том случае, если запрос возвращает несколько наборов результатов. Не все СУБД поддерживают эту функцию.

read() метод

public array|false read()

public function read()
{
    return $this->_statement->fetch();
}

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

readAll() метод

public array readAll()

public function readAll()
{
    return $this->_statement->fetchAll();
}

Считывает весь набор результатов в массив.

readColumn() метод

public mixed|false readColumn(integer $columnIndex)

public function readColumn($columnIndex)
{
    return $this->_statement->fetchColumn($columnIndex);
}

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

readObject() метод

public mixed|false readObject(string $className, array $fields)

public function readObject($className,$fields)
{
    return $this->_statement->fetchObject($className,$fields);
}

Возвращает объект, заполненный следующей строкой данных.

rewind() метод

public void rewind()

public function rewind()
{
    if($this->_index<0)
    {
        $this->_row=$this->_statement->fetch();
        $this->_index=0;
    }
    else
        throw new CDbException(Yii::t('yii','CDbDataReader cannot rewind. It is a forward-only reader.'));
}

Сбрасывает итератор в начальное состояние. Этот метод необходим для интерфейса Iterator.

setFetchMode() метод

public void setFetchMode(mixed $mode)

public function setFetchMode($mode)
{
    $params=func_get_args();
    call_user_func_array(array($this->_statement,'setFetchMode'),$params);
}

Устанавливает режим извлечения по умолчанию для данного оператора.

valid() метод

public boolean valid()

public function valid()
{
    return $this->_row!==false;
}

Возвращает, есть ли строка данных в текущей позиции. Этот метод необходим для интерфейса Iterator.