Доступные версии документации

Дать следующую запись выборки данных

Назначение
 

Команда GETN возвращает следующую (после текущей)запись выборки данных.

Параметры вызова

inter(CBL, VarBuf, NULL, [CondBuf], RowBuf);

Входные данные

Входными данными является контрольный блок CBL.

В нем должны быть заполнены поля:

Имя поля Значение
NumChan Номер канала
Command "GETN"
LnBufRow Длина буфера выборки данных
Node Имя ЛИНТЕР-сервера
Выходные данные

Выходными данными являются:

  • контрольный блок CBL;

  • буфер выборки данных RowBuf;

  • буфер параметров VarBuf.

В контрольном блоке будут возвращены:

Имя поля Значение
CodErr Код завершения запроса к СУБД ЛИНТЕР
RowId Системный номер выбранной записи
LnBufRow Фактическая длина буфера выборки данных
SysErr Код состояния ОС

Буфер выборки данных RowBuf будет содержать следующую (после текущей) запись выборки данных.

В буфере VarBuf возвращается маска NULL-значений.

Описание

Команда выдает следующую запись выборки данных после текущей записи выборки. Текущей записью является последняя запись, реально выданная по данному каналу.

Коды завершения
Код Описание
NORMAL Нормальное завершение
SMALLBUFKOR Недостаточный размер буфера выборки данных
EORR Искомые данные не найдены (выборка данных пуста, или запрашивается следующая запись после последней в выборке)
ERRSEQCOM Неправильная последовательность команд (команда GETN подана вне контекста SELECT-запроса)
Пример формирования команды
#include <string.h>
#include <stdlib.h>
#include "inter.h"

L_LONG LinterGETN(TCBL *pCBL, void *RowBuf, L_WORD RowBufLen, void *NullBuf)
   {
   memcpy(pCBL->Command, "GETN", 4);
   pCBL->LnBufRow=RowBufLen;
   pCBL->PrzExe &= ~Q_ASYNC;
   inter(pCBL, NullBuf, NULL, NULL, RowBuf);
   return pCBL->CodErr;
   }
Пример использования команды
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter