Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

Документация
Функция htJoinElement - Определить характеристики элемента таблицы группы

htJoinElement - Определить характеристики элемента таблицы группы

Назначение:

Функция носит вспомогательный характер и служит для определения характеристик элемента одной из таблиц, попавшей в группу связанных таблиц.

Прототип:

 int HTAPI htJoinElement(
	LPSAB, /* Результат связи */
	int nTableNo, /* Номер таблицы в группе таблиц (от 0) */
	int	 nElemNo, /* Номер элемента в таблице (от 0) */
	LPELEMENT fpElement, /* Структура для описания элемента */
	int	 nReadName /* !=0 читать имя элемента из файла */
 );

Параметры

fpSrc
задает адрес БДС, содержащего результаты связи некоторого числа таблиц (результаты htTablesJoin или htTablesLink).
nTableNo
задает порядковый номер таблицы в группе связанных таблиц. Нумерация таблиц идет от 0.
nElemNo
задает порядковый номер интересующего элемента в нужной таблице. Номер 0 используется для определения параметров физического номера таблицы
fpElement
задает адрес структуры для приема характеристик элемента
nReadName
задает флаг чтения имени элемента. Имя элемента будет считано, если задан флаг чтения, иначе оно будет заполнено символами \0. Если флаг чтения имени элемента не задан, функция извлекает описание элемента из внутренних переменных. При задании флага чтения имени функция считывает имя элемента из файла, что требует дополнительных временных затрат

Результат:

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

Пример.

Получить описание второго элемента третьей таблицы для приведенного выше примера (функция htTablesLink).

 ELEMENT sElem;
 int rc;
 . . .
 if( (rc = htJoinElement( &sRes, 2, 1, &sElem, 0 )) < 0 )
 /* Обработка ошибок */