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

Описания RDS

Приложения

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

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

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

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

# Приложения

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