Class template list_base_hook
boost::intrusive::list_base_hook
Synopsis
Description
Выберите класс из этого крючка, чтобы сохранить объекты этого класса в списке.
Для этого нужно выбрать следующие варианты:<tag<>>,<void_pointer<>>и<link_mode<>>.
<tag<>>определяет тег для идентификации узла. Одно и то же значение тега может использоваться в разных классах, но если класс получен из более чем одного<list_base_hook>, то каждый<list_base_hook>нуждается в своем уникальном теге.
<link_mode<>>будет указывать режим соединения крючка<normal_link>,<auto_unlink>или<safe_link>.
<void_pointer<>>- тип указателя, который будет использоваться внутри крючка и контейнера, сконфигурированного для использования этого крючка.
list_base_hook
public
construct/copy/destruct
- <
list_base_hook();
>Эффекты: Если<link_mode><auto_unlink>или<safe_link>инициализирует узел в несвязанное состояние.
Броски: Ничего.
- <
list_base_hook(constlist_base_hook&);
>Эффекты: Если<link_mode><auto_unlink>или<safe_link>инициализирует узел в несвязанное состояние. Аргумент игнорируется.
Бросает: Ничего.
Обоснование: Предоставление копи-конструктора делает занятия с помощью крючка STL-совместимыми, не заставляя пользователя выполнять какую-то дополнительную работу.<swap>может использоваться для эмуляции подвижной семантики.
- <
list_base_hook&operator=(constlist_base_hook&);
>Эффекты: Пустая функция. Аргумент игнорируется.
Бросает:
Обоснование: Предоставление оператора присваивания делает классы с использованием крючка STL-совместимыми, не заставляя пользователя выполнять некоторую дополнительную работу.<swap>может использоваться для эмуляции подвижной семантики.
- <
~list_base_hook();
>Эффекты: Если<link_mode><normal_link>, деструктор ничего не делает (т.е. код не генерируется). Если<link_mode><safe_link>и объект хранится в списке, то высказывание поднимается. Если<link_mode><auto_unlink>и<is_linked()>истинно, то узел несвязан.
Бросок: Ничего.
list_base_hook public member functions
- <
voidswap_nodes(list_base_hook&other);
>Эффекты: Переключение двух узлов меняет положение элементов, связанных с этими узлами, в одном или двух контейнерах. То есть, если узел является частью элемента e1, узел x является частью элемента e2 и оба элемента включены в контейнеры s1 и s2, то после операции обмена e1 находится в s2 в положении e2, а e2 находится в s1 в положении e1. Если один элемент не находится в контейнере, то после операции обмена другой элемент не находится в контейнере. Итераторы e1 и e2, относящиеся к этим узлам, недействительны.
Сложность: Постоянная
Бросает: Ничего.
- <
boolis_linked()const;
>Предварительное условие:<link_mode>должно быть<safe_link>или<auto_unlink>.
Возвращение: истинно, если узел принадлежит контейнеру, ложно в противном случае. Эта функция может использоваться для проверки того, вернет ли<list::iterator_to>действительный итератор.
Сложность: Постоянство
- <
voidunlink();
>Эффекты: Удаляет узел, если он вставлен в контейнер. Эта функция допускается только в том случае, если<link_mode><auto_unlink>.
Бросает: Ничего.
