Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

Документация
Функция fn_htValuesFromGroup

htValuesFromGroup - Построение списка значений элемента по результатам группировки

Назначение:

Функция предназначена для работы с результатами группировки. Она позволяет "вырезать" из результатов группировки значения какого-либо поля (как образующего группу, так и функционала) и сформировать список его уникальных значений. Полученный список значений поля оформляется так, как будто бы от был получен в результате выполнения функции htValuesOfKey на данной таблице.

Прототип:

LPSAB HTAPI htValuesFromGroup(
	LPSAB fpDst,		/* Для приема списка значений ключа */
	int	 nElemNo,	/* Номер поля, значения которого собираются */
	unsigned wOffset,	/* Смещение начала поля */
	LPSAB fpGroup	/* Результаты GroupBy */
);

Параметры

fpDst
задает адрес БДС, предназначенного для приема списка значений элемента
nElemNo
задает номер элемента, значения которого будут выделяться из результатов группировки. Имеется в виду номер элемента в таблице (а не в результате группирования). Например, если группировка была выполнена для 2, 5 и 7 элементов таблицы и вычислен один функционал, то в качестве параметра допустимо задать номер 2, 5, или 7. Отнюдь не 1, 2, 3 или 4. Можно также задать номер элемента, "накладываемого" на функционал. Важно, чтобы длина элемента и функционала совпадали.
wOffset
задает величину смещения выбираемых значений элемента в элементе группировки
fpGroup
задает адрес БДС, содержащего результаты результаты группировки. Доступ к этим результатам должен быть закрыт

Поскольку гистограмма - тоже своего рода группировка, функция применима к результатам поиска - гистограммам. При этом, однако, номер ключа и его смещение предопределены и сохранены в исходном БДС. Второй и третий параметр функции в этом случае можно приравнять 0.

Результат:

значение первого параметра при успешном завершении
NULL в случает ошибки (код содержится в поле fpDst->nRetCode).