Навигация по набору данных

Материал из K3-Macro
Макро | Унифицированная работа с базами данных | Подключение к базе данных | Получение набора данных | Информация о наборе данных | Навигация по набору данных | Получение данных из набора | Модификация данных | Транзакции | Вспомогательные функции | Заполнения массива набором записей

В результате SQL запроса, формируется таблица данных – набор записей. Для перемещения (навигации) по записям набора используются несколько функций.


INT adbMoveFirst(INT <idRs>)

Функция adbMoveFirst устанавливает текущей первую запись в наборе записей с номером <idRs>. В случае успешного завершения функция возвращает значение равное единице. В противном случае возвращается отрицательное число, представляющее собой код ошибки.


INT adbMoveLast(INT <idRs> )

Функция adbMoveLast устанавливает текущей последнюю запись в наборе записей с номером <idRs>. В случае успешного завершения функция возвращает значение равное единице. В противном случае возвращается отрицательное число, представляющее собой код ошибки.


INT adbMoveNext(INT <idRs>)

Функция adbMoveNext устанавливает текущей следующую запись в наборе записей с номером <idRs>. В случае успешного завершения функция возвращает значение равное единице. В противном случае возвращается отрицательное число, представляющее собой код ошибки.


INT adbMovePrev(INT <idRs>)

Функция adbMovePrev устанавливает текущей предыдущую запись в наборе записей с номером <idRs>. В случае успешного завершения функция возвращает значение равное единице. В противном случае возвращается отрицательное число, представляющее собой код ошибки.


INT adbGoTo(INT <idRs>, INT <Num>)

Функция adbGoTo устанавливает текущей указанную номером <Num> запись в наборе записей с номером <idRs>. Записи нумеруются, начиная с нуля. В случае успешного завершения функция возвращает значение равное единице. В противном случае возвращается отрицательное число, представляющее собой код ошибки.

При навигации по набору записей необходимо отслеживать текущее положение указателя в наборе. Для этого существуют следующие функции.


LOGICAL adbIsBOF(INT <idRs>)

Функция adbIsBOF проверяет, не достигнуто ли начало набора записей с номером <idRs>. То есть не находится ли указатель записей перед первой записью. Функция возвращает:

0 — начало набора записей не достигнуто
1 — начало набора записей достигнуто


LOGICAL adbIsEOF(INT <idRs>)

Функция adbIsEOF проверяет, не достигнут ли конец набора записей с номером <idRs>. То есть не находится ли указатель записей после последней записи. Функция возвращает:

0 — конец набора записей не достигнут
1 — конец набора записей достигнут

Макро | Унифицированная работа с базами данных | Подключение к базе данных | Получение набора данных | Информация о наборе данных | Навигация по набору данных | Получение данных из набора | Модификация данных | Транзакции | Вспомогательные функции | Заполнения массива набором записей