Приложения

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

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

А.5.15. Работа с матрицами и массивами

А.5.15.6. Макрос RDS_ARRAYROWS – число строк матрицы/массива

Макрос RDS_ARRAYROWS возвращает число строк (первый индекс) в статической или динамической переменной блока, являющейся матрицей или массивом. В массиве число строк всегда равно единице.

  RDS_ARRAYROWS(
    baseaddr    // Указатель на переменную
  )

Определение

  #define RDS_ARRAYROWS(baseaddr) \
    ( *(*((RDSINT32**)(baseaddr))) )

Параметр

baseaddr (указатель)

Указатель (может быть любого типа, в т.ч. и void*) на данные переменной в дереве переменных блока.

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

Число строк в матрице/массиве.

Примечания

По указателю baseaddr в дереве переменных блока находятся восемь байтов, описывающих матрицу. Четыре первых байта занимает указатель на данные матрицы. Если матрица пуста, этот указатель будет равен NULL, если нет, в области памяти, на которую он указывает, будут размешаться два тридцатидвухбитных целых числа, в первом из которых хранится число строк матрицы, во втором – число столбцов, а за ними последовательно размещаются значения элементов матрицы. Макрос RDS_ARRAYROWS возвращает первое из этих двух чисел. Массивы в RDS хранятся в памяти так же, как и матрицы, поэтому этот макрос можно применять как для матриц, так и для массивов, хотя для массивов он всегда будет возвращать единицу.

Поскольку в макросе RDS_ARRAYROWS отсутствует проверка указателя на данные матрицы на значение NULL, и он сразу обращается к этим данным, использовать его можно только после проверки на существование матрицы, например, макросом RDS_ARRAYEXISTS. При желании, вместо макросов, работающих непосредственно с данными переменной, для получения описания матрицы или массива можно использовать структуру RDS_ARRAYACCESSDATA и функции, работающие с ней.

Пример

Пример использования макроса RDS_ARRAYROWS приведен в §2.5.3 руководства программиста.

См. также

RDS_ARRAYCOLS, RDS_ARRAYEXISTS, RDS_ARRAYDATA, RDS_ARRAYACCESSDATA.