Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.14. Общие функции работы с переменными блока

А.5.14.16. rdsSetBlockVarDefValueByCur – сделать текущее значение переменной блока значением по умолчанию

Функция rdsSetBlockVarDefValueByCur копирует текущее значение статической переменной указанного блока с заданным номером в ее значение по умолчанию.

  BOOL RDSCALL rdsSetBlockVarDefValueByCur(
    RDS_BHANDLE Block,  // Идентификатор блока
    int VarNum          // Номер переменной
  );

Тип указателя на эту функцию

RDS_BBhI

Параметры

Block (RDS_BHANDLE): Идентификатор блока, которому принадлежит переменная.
VarNum (int): Порядковый номер переменной в блоке (начиная с нуля).

Возвращаемое значение

TRUE – значение переменной по умолчанию установлено, FALSE – в блоке нет переменной с таким номером.

Примечания

Эта функция позволяет сделать текущее значение какой-либо статической переменной блока значением по умолчанию, то есть значением, автоматически присваиваемым переменной после загрузки схемы или сброса расчета.

Следует помнить, что для элемента массива и матрицы может быть задано только одно значение по умолчанию, поэтому, если переменная с номером VarNum – массив или матрица, после вызова rdsSetBlockVarDefValueByCur в качестве значения по умолчанию для этой переменной будет запомнен текущий размер этой матрицы (массива) и значение ее нулевого элемента.

Пример

Пример использования функции rdsSetBlockVarDefValueByCur приведен в §2.7.5 руководства программиста.

См. также

rdsSetBlockVarDefValueStr, rdsGetBlockVarDefValueStr.