Функция addsubstr добавляет подстроку (в терминах HyTech) к существующей таблице. Подстрока представляет собой дополнительный индекс, по которому можно производить поиск.
Функцию addsubstr надо вызывать сразу после создания таблицы для занесения в ее структуру указанную подстроку. Чтобы добавить в таблицу несколько подстрок, необходимо вызвать функцию addsubstr несколько раз.
Имя таблицы. Таблица должна быть закрыта всеми пользователями.
sGroupName
character
Имя добавляемой подстроки. Не должно совпадать с уже существующими полями, группами или подстроками в таблице и не должно иметь имя recno.
nFieldStart
integer
Номер поля, в котором располагается подстрока. Поля в таблице перенумерованы, начиная с 1.
nOffset
integer
Смещение в поле, где начинается подстрока.
nLen
integer
Длина подстроки в байтах.
nKey
integer
Тип ключа. Если параметр не указан, то создается обычный ключ.
Допустимые значения аргумента nKey
nKey
Значение
Обычный ключ.
Уникальный ключ.
Результат:
Тип
Значение
integer
Код ошибки HyTech или 0, если успех.
Пример:
drop table READER;
create table READER ( ID dword surrogate, BOOKCOUNT byte, DEPOSIT currency, BIRTHDATE date, LNAME char(50) not null, FNAME char(50) not null, MNAME char(50) not null, RNUM char(10) not null, WORKPLACE char(100) );
close table READER;
var @rc = 0; @rc = addsubstr('READER', 'NAME2', 6, 5, 10, 1); if (@rc <> 0) { select 'Ошибка при создании подстроки: ' + @rc as RESULT from TABLES; } else { select 'Подстрока создана: ' + @rc as RESULT from TABLES; }