Приложения
Приложение А. Функции, константы и структуры 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*.
См. также