Приложения

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

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

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

А.5.25.12. rdsVSFindAutoConn – найти имя связанной переменной

Функция rdsVSFindAutoConn возвращает имя связанной переменной (связанного сигнала или управляющей переменной) для указанного имени главной.

  RDSCSTR RDSCALL rdsVSFindAutoConnA(
    RDS_HOBJECT Vars,    // Редактор переменных
    RDSCSTR MainVarName  // Имя главной переменной (UTF8)
  );
  RDSWCSTR RDSCALL rdsVSFindAutoConnW(
    RDS_HOBJECT Vars,    // Редактор переменных
    RDSWCSTR MainVarName // Имя главной переменной (UTF16)
  );
  // Функция-псевдоним
  RDSXCSTR RDSCALL rdsVSFindAutoConn(
    RDS_HOBJECT Vars,    // Редактор переменных
    RDSXCSTR MainVarName // Имя главной переменной (кодировка по умолчанию)
  );

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

RDS_SHoS (для UTF8) или RDS_WsHoWs (для UTF16)

Параметры

Vars (RDS_HOBJECT)

Идентификатор вспомогательного объекта-редактора переменных, ранее созданного функцией rdsVSCreateEditor.

MainVarName (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с именем главой переменной, для которой нужно найти связанную.

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

Указатель на строку с именем связанной переменной во внутренней памяти объекта, или NULL, если для указанной главной переменной нет связанной.

Примечания

Эта функция возвращает указатель на имя связанной переменной для главной переменной MainVarName (связанные переменные добавляются функцией rdsVSAddAutoConn). Имя находится во внутренней памяти объекта Vars, этим указателем можно пользоваться только до тех пор, пока содержимое объекта не будет изменено.

Использование связей вспомогательных переменных с основными в моделях блоков описывается в §2.5.7 и §2.5.8 руководства программиста.

См. также

rdsVSCreateEditor, rdsVSAddAutoConn, RDS_HVAR_GETAUTOCONN, RDS_HVAR_GETAUTOCOUNT, RDS_HVAR_GETAUTOMAIN.