linter_fetch

Назначение

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

Синтаксис

 
linter_fetch cursorId [direction] [position] [rowCounter]
Параметр Описание
cursorId  Идентификатор открытого курсора.
direction  

Направление перемещения в выборке данных:

  • toNext – на следующую запись после текущей (значение по умолчанию);

  • toPrevious – на предыдущую после текущей;

  • toFirst – на первую;

  • toLast – на последнюю;

  • toAbsNumber – на запись с абсолютным номером position;

  • toRelNumber – на запись с номером position относительно текущей строки.

position  Номер записи (для параметров toAbsNumber, toRelNumber). Нумерация начинается с 1.
rowCounter  Запрашиваемая порция записей выборки данных (по умолчанию 1 запись). Отрицательное значение преобразуется к единице.

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

Значение Описание
≥0  Количество строк, занесенных в буфер ответа (нормальное завершение).
< 0  Код завершения (ошибка выполнения команды).

Примеры

# Переместиться на последнюю строку выборки
if  {[catch {linter_fetch $curs toLast} err]} {
  puts [linter_error];
}

См. также test.tcl и test1.tcl в подкаталоге /sample/tcl установочного каталога СУБД ЛИНТЕР.