Приложения

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

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

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

А.5.24.3. rdsBCLAddConn – добавление связи или шины в список

Функция rdsBCLAddConn добавляет в список блоков и связей связь или шину с указанным идентификатором.

  int RDSCALL rdsBCLAddConn(
    RDS_HOBJECT List,  // Список
    RDS_CHANDLE Conn,  // Связь
    BOOL IgnoreDup     // Игнорировать повторы
  );

Тип указателя на эту функцию

RDS_IHoChB

Параметры

List (RDS_HOBJECT)

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

Conn (RDS_CHANDLE)

Идентификатор связи или шины, которую нужно добавить во внутренний массив объекта List.

IgnoreDup (BOOL)

TRUE – перед добавлением проверить, нет ли уже в списке связи (шины) с идентификатором Conn. Если она есть, второй раз она добавлена не будет. FALSE – добавлять связь в любом случае, даже если она уже есть в списке (ускоряет работу при больших размерах списков, но может привести к повторам идентификаторов связей и шин в списке).

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

Индекс добавленной связи или шины во внутреннем массиве объекта List. Если в параметре IgnoreDup было передано значение TRUE, и связь с идентификатором Conn уже находится в массиве, функция вернет индекс найденного идентификатора Conn.

Примечания

Эта функция позволяет добавлять в список отдельные связи и шины. Для определения общего числа связей и шин в списке следует использовать команду RDS_HBCL_CONNCOUNT, для получения указателя на внутренний массив идентификаторов связей и шин – команду RDS_HBCL_CONNARRAY. Функция удаления связей из списка не предусмотрена: для того, чтобы выбросить связь или шину из списка, следует вручную заменить в массиве ее идентификатор на NULL.

Пример

Пример использования функции rdsBCLAddConn приведен в §2.16.2 руководства программиста.

См. также

rdsBCLCreateList, rdsBCLAddBlock, RDS_HBCL_CONNCOUNT, RDS_HBCL_CONNARRAY, RDS_HBCL_CLEAR.