Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

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

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

Назначение:

Часто бывает полезно иметь не только список значений поля, но и его гистограмму (список пар - значение:повторы).

Функция служит для вычисления полной гистограммы значений элемента (поля, группы или подстроки) на заданном подмножестве записей.

Гистограммы значений не могут быть использованы в качестве операндов логических операций.

Прототип:

int HTAPI htHistogramOfKey(
	LPSAB 	fpDst,   	/* Для приема результата */
	int   	nElemNo, 	/* Номер элемента записи */
	LPSAB 	fpSrc    	/* Адрес БДС, содержащего список записей */
 );

Параметры

fpDst
задает адрес БДС для приема результата
nElemNo
задает номер элемента, для которого будет построена гистограмма значений. Нумерация элементов в записи начинается с единицы
fpSrc
задает адрес БДС, содержащего подмножество записей, на котором строится гистограмма.

Результат:

0 при успешном завершении
отрицательное число код ошибки

Пример.

Получить список фамилий с число повторов.

typedef struct tagREC { /* Структура записи таблицы */
	char name[10];
	char sex;
	int room;
} REC;
int rc;
SAB sAll;
SAB sHisto;
THANDLE hTable;
 . . .
/* Список всех людей */
if( !htSearch( NULL, &sAll, hTable, 0, GREAT, "\0\0\0", NULL ) )
	/* Обработка ошибок */
 . . .
/* Построение гистограммы фамилий на подмножестве */
if( (rc = htHistogramOfKey( &sHisto, 1, &sAll )) < 0 )
	/* Обработка ошибок */