Навигация по набору данных
В результате 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 — конец набора записей достигнут