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

Описания RDS

Приложения

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

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

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

А.5.25.24. Команда RDS_HVAR_GETAUTOMAIN – получить имя основной переменной по номеру связи

# Приложения

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

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

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

##### А.5.25.24. Команда RDS_HVAR_GETAUTOMAIN – получить имя основной переменной по номеру связи

Команда RDS_HVAR_GETAUTOMAIN возвращает имя основной переменной по номеру ее связи со вспомогательной.

Вызов команды

      int iNum= … // Номер связи "основная-вспомогательная"
      RDSCSTR strName=rdsGetObjectStrA(Vars,RDS_HVAR_GETAUTOMAIN,iNum); //UTF8

или

      int iNum= … // Номер связи "основная-вспомогательная"
      RDSWCSTR strName=rdsGetObjectStrW(Vars,RDS_HVAR_GETAUTOMAIN,iNum); //UTF16

или (через функцию-псевдоним)

      int iNum= … // Номер связи "основная-вспомогательная"
      RDSXCSTR strName=rdsGetObjectStr(Vars,RDS_HVAR_GETAUTOMAIN,iNum); //Кодировка по умолчанию

Параметры и результат

Vars(RDS_HOBJECT)
  Идентификатор вспомогательного объекта-редактора переменных, ранее созданного функцией rdsVSCreateEditor.
iNum(int)
  Целое число – номер связи переменных.
strName(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку во внутренней памяти RDS, в которой записано имя основной переменной, или NULL, если связи с номером iNum нет в объекте Vars.

Примечания

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

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

См. также

rdsVSCreateEditor, rdsGetObjectStr, rdsVSAddAutoConn, rdsVSFindAutoConn, RDS_HVAR_GETAUTOCONN, RDS_HVAR_GETAUTOCOUNT.