Функция получения идентификатора сигнала в базе
Синтаксис:
sid = dbsignalid(s_name); sid = dbsignalid(s_name,copy_index);
Аргументы:
| Имя | Тип данных | Описание |
|---|---|---|
| s_name | string | Входной аргумент, полное имя сигнала ({имя группы}_{имя сигнала}), идентификатор которого нужно получить |
| copy_index | integer | Дополнительный входной целочисленный аргумент, содержит номер повторяющегося сигнала (начиная с нуля), информацию о котором нужно получить. * |
Описание:
dbsignalid – функция позволяет получить идентификатор данных сигнала с полным именем s_name. В случае, если в группе содержатся сигналы с одинаковыми именами, то задавать порядковый номер (начиная с нуля) необходимого сигнала можно с помощью аргумента copy_index.
Прим.: аргумент copy_index работает только если в
настройках базы сигналов включен режим множественного поиска переменной
Результат:
| Имя | Тип данных | Описание |
|---|---|---|
| sid | integer | Функция возвращает целочисленный идентификатор (sid) заданного сигнала в базе. Если сигнал в базе не существует, то функция вернет 0. Далее можно оперировать с полями сигнала например при помощи функций: getdatacaption (функция получения названия свойства, или присваивания нового названия свойству объекта), getdataformula (функция получения интерпретируемого выражения свойства, или присваивания нового интерпретируемого выражения свойству объекта) или getdataname функция получения или присвоения имени свойства объекта. |
Пример:
sid = dbsignalid("g1_signal",0); if sid <> 0 then getdatacaption(sid) = "New caption";
В результате выполнения данного скрипта, в качестве названия сигнала g1_signal будет установлена строка "New caption".
Дополнительные материалы
Нет.
