Текущий раздел:

Описания RDS

Приложения

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

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

А.5.25. Вспомогательный объект для изменения структуры переменных блока

А.5.25.2. rdsVSAddAutoConn – добавить связь с управляющей переменной

# Приложения

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

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

#### А.5.25. Вспомогательный объект для изменения структуры переменных блока

##### А.5.25.2. rdsVSAddAutoConn – добавить связь с управляющей переменной

Функция rdsVSAddAutoConn добавляет в объект-редактор переменных связь основной переменной (входа или выхода) со вспомогательной (связанным сигналом для входа или управляющей переменной для выхода). Использование вспомогательных переменных в моделях блоков описывается в §2.5.7 и §2.5.8 руководства программиста.

      int RDSCALL rdsVSAddAutoConnA(
        RDS_HOBJECT Vars,     // Редактор переменных
        RDSCSTR MainVarName,  // Основная переменная (UTF8)
        RDSCSTR ConnVarName   // Вспомогательная переменная (UTF8)
      );
      int RDSCALL rdsVSAddAutoConnW(
        RDS_HOBJECT Vars,     // Редактор переменных
        RDSWCSTR MainVarName, // Основная переменная (UTF16)
        RDSWCSTR ConnVarName  // Вспомогательная переменная (UTF16)
      );
      // Функция-псевдоним
      int RDSCALL rdsVSAddAutoConn(
        RDS_HOBJECT Vars,     // Редактор переменных
        RDSXCSTR MainVarName, // Основная переменная (кодировка по умолчанию)
        RDSXCSTR ConnVarName  // Вспомогательная переменная (кодировка по умолчанию)
      );

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

RDS_IHoSS (для UTF8) или RDS_IHoWsWs (для UTF16)

Параметры

Vars(RDS_HOBJECT)
  Идентификатор вспомогательного объекта-редактора переменных, ранее созданного функцией rdsVSCreateEditor.
MainVarName(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку с именем основной переменной (входа или выхода).
ConnVarName(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку с именем вспомогательной переменной (связанного сигнала для входа или управляющей переменной для выхода).

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

Номер добавленной связи или −1 в случае ошибки (такая связь уже существует).

Примечания

Эта функция позволяет привязать в входу блока сигнальную переменную, которая будет автоматически взводиться при срабатывании связи, подключенной к этому входу, или привязать к выходу блока логическую или целую переменную, разрешающую срабатывание связи, идущей от этого выхода. В параметрах функции указывается имя входа или выхода (MainVarName) и имя связанной переменной (ConnVarName).

См. также

rdsVSCreateEditor, rdsVSApplyToBlock, RDS_HVAR_GETAUTOCONN, RDS_HVAR_GETAUTOCOUNT, RDS_HVAR_GETAUTOMAIN.