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

Описания RDS

Приложения

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

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

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

А.5.24.11. Макрос rdsBCLGetBlockArray – получение массива блоков

# Приложения

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

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

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

##### А.5.24.11. Макрос rdsBCLGetBlockArray – получение массива блоков

Макрос rdsBCLGetBlockArray предназначен для получения указателя на внутренний массив идентификаторов блоков в объекте-списке и общего числа идентификаторов в этом массиве.

      rdsBCLGetBlockArray(
        list,    // Вспомогательный объект-список
        pcount   // Возвращаемое число элементов
      )

Определение

      #define rdsBCLGetBlockArray(list,pcount) \
          ((RDS_BHANDLE*)rdsGetObjectArray( \
            (list),RDS_HBCL_BLOCKARRAY,0,(pcount)))

Параметры

list(RDS_HOBJECT)
  Идентификатор вспомогательного объекта-списка, ранее созданного функцией rdsBCLCreateList.
pcount(int*)
  Указатель на целую переменную, в которую будет записано общее число блоков в списке. Может равняться NULL, если размер списка не нужен вызывающей программе.

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

Указатель на первый элемент внутреннего массива идентификаторов блоков объекта list, приведенный к типу «указатель на RDS_BHANDLE».

Примечания

Этот макрос заключает в себя вызов функции rdsGetObjectArray для выполнения команды получения массива блоков RDS_HBCL_BLOCKARRAY и приведение возвращенного указателя к типу RDS_BHANDLE*.

См. также

RDS_HBCL_BLOCKARRAY, rdsGetObjectArray.