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

Описания RDS

Приложения

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

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

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

А.5.14.15. rdsGetVarField – поле структуры или элемент массива по номеру

# Приложения

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

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

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

##### А.5.14.15. rdsGetVarField – поле структуры или элемент массива по номеру

Функция rdsGetVarField возвращает идентификатор поля структуры с указанным номером или элемента указанного массива/матрицы.

      RDS_VHANDLE RDSCALL rdsGetVarField(
        RDS_VHANDLE ParentVar,      // Переменная-владелец
        int VarNum,                 // Номер переменной
        RDS_PVARDESCRIPTION pDescr  // Заполняемое описание
      );

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

RDS_VhVhiVd

Параметры

ParentVar(RDS_VHANDLE)
  Идентификатор структуры или матрицы (массива), идентификатор элемента которой требуется получить.
VarNum(int)
  Порядковый номер поля структуры, начиная с нуля. Если ParentVar – массив или матрица, этот параметр игнорируется, поскольку все элементы массива или матрицы всегда обслуживаются одной и той же переменной-элементом (при изменении индекса меняется только базовый адрес данных, с которыми работает эта переменная).
pDescr(RDS_PVARDESCRIPTION)
  Указатель на структуру описания переменной RDS_VARDESCRIPTION, которую функция должна заполнить параметрами поля структуры с указанным номером или элемента массива. Если вызывающей программе не нужно описание переменной, в этом параметре можно передать NULL.

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

Идентификатор найденной переменной (тип RDS_VHANDLE) или NULL, если такой переменной нет.

Примечания

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

См. также

RDS_VARDESCRIPTION, rdsGetBlockVar.