Приложения
Приложение А. Функции, константы и структуры 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 руководства программиста) при формировании для переменных каких-либо вспомогательных классов доступа.
См. также