Приложения

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

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

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

А.5.25.29. Команда RDS_HVAR_GETVARRANK – получить уровень всей структуры переменных

Команда RDS_HVAR_GETVARRANK возвращает уровень всей структуры переменных указанного объекта-редактора.

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

  int iRank=rdsGetObjectInt(Vars,RDS_HVAR_GETVARRANK,0);

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

Vars (RDS_HOBJECT)

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

iRank (int)

Целое число – уровень структуры переменных объекта Vars, то есть максимальная вложенность элементов в этой структуре.

Примечания

Эта команда возвращает то же значение, которое записывается в поле Rank структуры RDS_VARDESCRIPTION при вызове функции rdsVSGetVarDescription для всего набора переменных (то есть со значением −1 вместо номера переменной). Уровень любой переменной в RDS – это максимальная вложенность ее элементов. Например, для любой простой переменной уровень будет равен нулю, для массива или матрицы вещественных чисел – единице (один вложенный элемент), для матрицы матриц целых – двум (внутри этой матрицы – еще одна матрица, внутри которой – целое число, то есть в переменной два элемента, вложенных один в другой). Для структуры переменных объекта-редактора уровень будет числом, на единицу большим максимального уровня всех переменных объекта, то есть если, например, структура будет состоять только из простых переменных, ее уровень будет равен единице.

См. также

rdsVSCreateEditor, rdsGetObjectInt, rdsVSGetVarDescription, RDS_VARDESCRIPTION.