Карта сайта Kansoftware
НОВОСТИУСЛУГИРЕШЕНИЯКОНТАКТЫ
Разработка программного обеспечения

Class template bs_multiset

Boost , The Boost C++ Libraries BoostBook Documentation Subset , Reference

Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext

Class template bs_multiset

boost::intrusive::bs_multiset

Synopsis

// In header: <boost/intrusive/bs_set.hpp>
template<typename T, class... Options> 
class bs_multiset {
public:
  // types
  typedef implementation_defined::value_type             value_type;            
  typedef implementation_defined::key_type               key_type;              
  typedef implementation_defined::value_traits           value_traits;          
  typedef implementation_defined::pointer                pointer;               
  typedef implementation_defined::const_pointer          const_pointer;         
  typedef implementation_defined::reference              reference;             
  typedef implementation_defined::const_reference        const_reference;       
  typedef implementation_defined::difference_type        difference_type;       
  typedef implementation_defined::size_type              size_type;             
  typedef implementation_defined::value_compare          value_compare;         
  typedef implementation_defined::key_compare            key_compare;           
  typedef implementation_defined::iterator               iterator;              
  typedef implementation_defined::const_iterator         const_iterator;        
  typedef implementation_defined::reverse_iterator       reverse_iterator;      
  typedef implementation_defined::const_reverse_iterator const_reverse_iterator;
  typedef implementation_defined::insert_commit_data     insert_commit_data;    
  typedef implementation_defined::node_traits            node_traits;           
  typedef implementation_defined::node                   node;                  
  typedef implementation_defined::node_ptr               node_ptr;              
  typedef implementation_defined::const_node_ptr         const_node_ptr;        
  typedef implementation_defined::node_algorithms        node_algorithms;       
  // construct/copy/destruct
  bs_multiset();
  explicit bs_multiset(const key_compare &, 
                       const value_traits & = value_traits());
  template<typename Iterator> 
    bs_multiset(Iterator, Iterator, const key_compare & = key_compare(), 
                const value_traits & = value_traits());
  bs_multiset(bs_multiset &&);
  bs_multiset & operator=(bs_multiset &&);
  ~bs_multiset();
  // public member functions
  iterator begin();
  const_iterator begin() const;
  const_iterator cbegin() const;
  iterator end();
  const_iterator end() const;
  const_iterator cend() const;
  reverse_iterator rbegin();
  const_reverse_iterator rbegin() const;
  const_reverse_iterator crbegin() const;
  reverse_iterator rend();
  const_reverse_iterator rend() const;
  const_reverse_iterator crend() const;
  iterator root();
  const_iterator root() const;
  const_iterator croot() const;
  key_compare key_comp() const;
  value_compare value_comp() const;
  bool empty() const;
  size_type size() const;
  void swap(bs_multiset &);
  template<typename Cloner, typename Disposer> 
    void clone_from(const bs_multiset &, Cloner, Disposer);
  template<typename Cloner, typename Disposer> 
    void clone_from(bs_multiset &&, Cloner, Disposer);
  iterator insert(reference);
  iterator insert(const_iterator, reference);
  template<typename Iterator> void insert(Iterator, Iterator);
  iterator insert_before(const_iterator, reference);
  void push_back(reference);
  void push_front(reference);
  iterator erase(const_iterator);
  iterator erase(const_iterator, const_iterator);
  size_type erase(const key_type &);
  template<typename KeyType, typename KeyTypeKeyCompare> 
    size_type erase(const KeyType &, KeyTypeKeyCompare);
  template<typename Disposer> 
    iterator erase_and_dispose(const_iterator, Disposer);
  template<typename Disposer> 
    iterator erase_and_dispose(const_iterator, const_iterator, Disposer);
  template<typename Disposer> 
    size_type erase_and_dispose(const key_type &, Disposer);
  template<typename KeyType, typename KeyTypeKeyCompare, typename Disposer> 
    size_type erase_and_dispose(const KeyType &, KeyTypeKeyCompare, Disposer);
  void clear();
  template<typename Disposer> void clear_and_dispose(Disposer);
  size_type count(const key_type &) const;
  template<typename KeyType, typename KeyTypeKeyCompare> 
    size_type count(const KeyType &, KeyTypeKeyCompare) const;
  iterator lower_bound(const key_type &);
  template<typename KeyType, typename KeyTypeKeyCompare> 
    iterator lower_bound(const KeyType &, KeyTypeKeyCompare);
  const_iterator lower_bound(const key_type &) const;
  template<typename KeyType, typename KeyTypeKeyCompare> 
    const_iterator lower_bound(const KeyType &, KeyTypeKeyCompare) const;
  iterator upper_bound(const key_type &);
  template<typename KeyType, typename KeyTypeKeyCompare> 
    iterator upper_bound(const KeyType &, KeyTypeKeyCompare);
  const_iterator upper_bound(const key_type &) const;
  template<typename KeyType, typename KeyTypeKeyCompare> 
    const_iterator upper_bound(const KeyType &, KeyTypeKeyCompare) const;
  iterator find(const key_type &);
  template<typename KeyType, typename KeyTypeKeyCompare> 
    iterator find(const KeyType &, KeyTypeKeyCompare);
  const_iterator find(const key_type &) const;
  template<typename KeyType, typename KeyTypeKeyCompare> 
    const_iterator find(const KeyType &, KeyTypeKeyCompare) const;
  std::pair< iterator, iterator > equal_range(const key_type &);
  template<typename KeyType, typename KeyTypeKeyCompare> 
    std::pair< iterator, iterator > 
    equal_range(const KeyType &, KeyTypeKeyCompare);
  std::pair< const_iterator, const_iterator > 
  equal_range(const key_type &) const;
  template<typename KeyType, typename KeyTypeKeyCompare> 
    std::pair< const_iterator, const_iterator > 
    equal_range(const KeyType &, KeyTypeKeyCompare) const;
  std::pair< iterator, iterator > 
  bounded_range(const key_type &, const key_type &, bool, bool);
  template<typename KeyType, typename KeyTypeKeyCompare> 
    std::pair< iterator, iterator > 
    bounded_range(const KeyType &, const KeyType &, KeyTypeKeyCompare, bool, 
                  bool);
  std::pair< const_iterator, const_iterator > 
  bounded_range(const key_type &, const key_type &, bool, bool) const;
  template<typename KeyType, typename KeyTypeKeyCompare> 
    std::pair< const_iterator, const_iterator > 
    bounded_range(const KeyType &, const KeyType &, KeyTypeKeyCompare, bool, 
                  bool) const;
  iterator iterator_to(reference);
  const_iterator iterator_to(const_reference) const;
  pointer unlink_leftmost_without_rebalance();
  void replace_node(iterator, reference);
  void remove_node(reference);
  template<class... Options2> void merge(bs_multiset< T, Options2...> &);
  template<class... Options2> void merge(bs_set< T, Options2...> &);
  // public static functions
  static bs_multiset & container_from_end_iterator(iterator);
  static const bs_multiset & container_from_end_iterator(const_iterator);
  static bs_multiset & container_from_iterator(iterator);
  static const bs_multiset & container_from_iterator(const_iterator);
  static iterator s_iterator_to(reference);
  static const_iterator s_iterator_to(const_reference);
  static void init_node(reference);
  // public data members
  static const bool constant_time_size;
};

Description

Шаблон классаbs_multisetявляется навязчивым контейнером, который имитирует большую часть интерфейса std::multiset, как описано в стандарте C++.

Параметр шаблона<T>— тип, которым должен управлять контейнер. Пользователь может указать дополнительные опции и, если опции не предусмотрены, используются опции по умолчанию.

Контейнер поддерживает следующие варианты:<base_hook<>/member_hook<>/value_traits<>>,<constant_time_size<>>,<size_type<>>и<compare<>>.

bs_multiset public construct/copy/destruct

  1. <
    bs_multiset();
    >

    Эффекты: Постройте пустой контейнер.

    Сложность: Постоянная.

    Бросает: Если value_traits::node_traits::node constructor throws (это не происходит с заранее заданными Boost.Intrusive крючками) или копи-конструктор key_compare object throws. Базовая гарантия.

  2. <
    explicitbs_multiset(constkey_compare&cmp,
                        constvalue_traits&v_traits=value_traits());
    >

    Эффекты: Постраивает пустой контейнер с заданными сравнениями и чертами.

    Сложность: Постоянная.

    Бросает: Если value_traits::node_traits::node constructor throws (это не происходит с заранее заданными Boost.Intrusive крючками) или копи-конструктор key_compare object throws. Базовая гарантия.

  3. <
    template<typenameIterator>
     bs_multiset(Iteratorb,Iteratore,constkey_compare&cmp=key_compare(),
                 constvalue_traits&v_traits=value_traits());
    >

    Требуется: Отклоняющий итератор должен давать значение l типа value_type. cmp должна быть функцией сравнения, которая вызывает строгий слабый порядок.

    Эффекты: Конструирует пустой контейнер и вставляет элементы из [b, e]

    .Сложность: Линейный в N, если [b, e] уже отсортирован с использованием comp и иначе N * log N, где N — расстояние между первым и последним.

    Бросает: Если value_traits::node_traits::node constructor throws (это не происходит с предопределенным Boost). Навязчивые крючки или конструктор/оператор() копий бросков объекта key_compare. Базовая гарантия.

  4. <
    bs_multiset(bs_multiset&&x);
    >

    Эффекты: делать

  5. <
    bs_multiset&operator=(bs_multiset&&x);
    >

    Эффекты: делать

  6. <
    ~bs_multiset();
    >

    Эффекты: Отделяет от этого все элементы. Объекты в наборе не удаляются (т.е. не называются деструкторы), но узлы по шаблонному параметру<value_traits>перезапускаются и, таким образом, могут быть повторно использованы.

    Сложность: Линейные элементы, содержащиеся в *это.

    Бросает: Ничего.

bs_multiset public member functions

  1. <
    iteratorbegin();
    >

    Эффекты: Возвращает итератор, указывающий на начало контейнера.

    Сложность: Постоянная.

    Бросает: Ничего.

  2. <
    const_iteratorbegin()const;
    >

    Эффекты: Возвращает const_iterator, указывающий на начало контейнера.

    Сложность: Постоянная.

    Бросает: Ничего.

  3. <
    const_iteratorcbegin()const;
    >

    Эффекты: Возвращает const_iterator, указывающий на начало контейнера.

    Сложность: Постоянная.

    Броски: Ничего.

  4. <
    iteratorend();
    >

    Эффекты: Возвращает итератор, указывающий на конец контейнера.

    Сложность: Постоянная.

    Бросает: Ничего.

  5. <
    const_iteratorend()const;
    >

    Эффекты: Возвращает const_iterator, указывающий на конец контейнера.

    Сложность: Постоянная.

    Бросает: Ничего.

  6. <
    const_iteratorcend()const;
    >

    Эффекты: Возвращает const_iterator, указывающий на конец контейнера.

    Сложность: Постоянная.

    Бросает: Ничего.

  7. <
    reverse_iteratorrbegin();
    >

    Эффекты: Возвращает обратный_iterator, указывающий на начало обратного контейнера.

    Сложность: Постоянная.

    Бросает: Ничего.

  8. <
    const_reverse_iteratorrbegin()const;
    >

    Эффекты: Возвращает const_reverse_iterator, указывающий на начало обратного контейнера.

    Сложность: Постоянная.

    Броски: Ничего.

  9. <
    const_reverse_iteratorcrbegin()const;
    >

    Эффекты: Возвращает const_reverse_iterator, указывающий на начало обратного контейнера.

    Сложность: Постоянная.

    Броски: Ничего.

  10. <
    reverse_iteratorrend();
    >

    Эффекты: Возвращает обратный_iterator, указывающий на конец обратного контейнера.

    Сложность: Постоянная.

    Броски: Ничего.

  11. <
    const_reverse_iteratorrend()const;
    >

    Эффекты: Возвращает const_reverse_iterator, указывающий на конец обратного контейнера.

    Сложность: Постоянная.

    Броски: Ничего.

  12. <
    const_reverse_iteratorcrend()const;
    >

    Эффекты: Возвращает const_reverse_iterator, указывающий на конец обратного контейнера.

    Сложность: Постоянная.

    Броски: Ничего.

  13. <
    iteratorroot();
    >

    Эффекты: Возвращает итератор, указывающий на корневой узел контейнера или конец(), если он не присутствует.

    Сложность: Постоянная.

    Броски: Ничего.

  14. <
    const_iteratorroot()const;
    >

    Эффекты: Возвращает const_iterator, указывающий на корневой узел контейнера или кенд(), если он отсутствует.

    Сложность: Постоянная.

    Бросает: Ничего.

  15. <
    const_iteratorcroot()const;
    >

    Эффекты: Возвращает const_iterator, указывающий на корневой узел контейнера или кенд(), если он отсутствует.

    Сложность: Постоянная.

    Броски: Ничего.

  16. <
    key_comparekey_comp()const;
    >

    Эффекты: Возвращает объект key_compare, используемый контейнером.

    Сложность: Постоянная.

    Броски: Если бросит key_compare копи-конструктор.

  17. <
    value_comparevalue_comp()const;
    >

    Эффекты: Возвращает значение_сравнительный объект, используемый контейнером.

    Сложность: Постоянная.

    Бросает: Если value_compare копи-конструктор бросает.

  18. <
    boolempty()const;
    >

    Эффекты: Возвращается, если контейнер пуст.

    Сложность: Постоянная.

    Броски: Ничего.

  19. <
    size_typesize()const;
    >

    Эффекты: Возвращает количество элементов, хранящихся в контейнере.

    Сложность: Линейный к элементам, содержащимся в *это, если опция постоянного размера отключена. Постоянное время иначе.

    Бросает: Ничего.

  20. <
    voidswap(bs_multiset&other);
    >

    Эффекты: Изменить содержимое двух контейнеров.

    Сложность: Постоянная.

    Броски: Если сравнительный своп функтора бросает вызов.

  21. <
    template<typenameCloner,typenameDisposer>
     voidclone_from(constbs_multiset&src,Clonercloner,Disposerdisposer);
    >

    Требуется: Диспетчер::оператор()(поинт) не должен бросать. Клонер должен уступить узлам, эквивалентным исходным узлам.

    Эффекты: Стирает все элементы из *этого вызывающего Диспозитора::оператор()(указатель), клонирует все элементы из src, вызывающего Клонера::оператор()(const_reference) и вставляет их на *это. Копирует предикат из исходного контейнера.

    Если клонер бросает, все клонированные элементы несвязаны и расположены, вызывая Диспозитор::оператор()(указатель).

    Сложность: Линейный стертый плюс вставленные элементы.

    Бросок: Если клонер бросает или предикат копирования, задание бросает. Базовая гарантия.

  22. <
    template<typenameCloner,typenameDisposer>
     voidclone_from(bs_multiset&&src,Clonercloner,Disposerdisposer);
    >

    Требуется: Диспетчер::оператор()(указатель) не должен бросать. Клонер должен уступить узлам, эквивалентным исходным узлам.

    Эффекты: Стирает все элементы из *этого вызывающего Диспозитора::оператор()(указатель), клонирует все элементы из src, вызывающего Клонера::оператор()(ссылка) и вставляет их на *это. Копирует предикат из исходного контейнера.

    Если клонер бросает, все клонированные элементы несвязаны и расположены, вызывая Диспозитор::оператор()(указатель).

    Сложность: Линейный стертый плюс вставленные элементы.

    Бросок: Если клонер бросает или предикат копирования, задание бросает. Основная гарантия.

    Примечание: Эта версия может модифицировать исходный контейнер, полезный для реализации семантики перемещения.

  23. <
    iteratorinsert(referencevalue);
    >

    Требуется: Значение должно быть lvalue

    Эффекты: Вставляет значение в контейнер перед верхней границей.

    Сложность: Средняя сложность для вставочного элемента является наиболее логарифмической.

    Броски: Если выполняется внутренняя функция key_compare ordering. Сильная гарантия.

    Примечание: Не влияет на достоверность итераторов и ссылок. Копировальными конструкторами не называются.

  24. <
    iteratorinsert(const_iteratorhint,referencevalue);
    >

    Требуется: Значение должно быть значением l, а «наконечник» должен быть действительным итератором.

    Эффекты: Вставляет х в контейнер, используя «наконечник» в качестве подсказки, где он будет вставлен. Если «подсказка» находится в верхнем узле, вставка занимает постоянное время (два сравнения в худшем случае)

    Сложность: Логарифмическое вообще, но это амортизированное постоянное время, если t вставлено непосредственно перед намёком.

    Броски: Если выполняется внутренняя функция key_compare ordering. Сильная гарантия.

    Примечание: Не влияет на достоверность итераторов и ссылок. Копировальными конструкторами не называются.

  25. <
    template<typenameIterator>voidinsert(Iteratorb,Iteratore);
    >

    Требуется: Ссылочный итератор должен давать значение l типа value_type.

    Эффекты: Вставляет каждый элемент диапазона в контейнер перед верхней границей ключа каждого элемента.

    Сложность: Диапазон вставки, как правило, O(N * log(N)), где N - размер диапазона. Однако он является линейным в N, если диапазон уже отсортирован по значению_comp().

    Бросок: Ничего.

    Примечание: Не влияет на достоверность итераторов и ссылок. Копировальными конструкторами не называются.

  26. <
    iteratorinsert_before(const_iteratorpos,referencevalue);
    >

    Требуется: Значение должно быть значением l, "pos" должно быть действительным итератором (или концом) и должно быть датчиком значения после вставки в соответствии с предикатом

    Эффекты: Вставляет х в контейнер перед "по".

    Сложность: Постоянное время.

    Бросок: Ничего.

    Примечание: Эта функция не проверяет предварительные условия, поэтому, если «pos» не является преемником инварианта упорядочивания контейнера «value», он будет нарушен. Это низкоуровневая функция, которая используется только для повышения производительности продвинутыми пользователями.

  27. <
    voidpush_back(referencevalue);
    >

    Требуется: Значение должно быть lvalue, и оно должно быть не меньше, чем наибольший вставленный ключ

    Эффекты: Вставьте x в контейнер в последнем положении.

    Сложность: Постоянное время.

    Бросает: Ничего.

    Примечание: Эта функция не проверяет предварительные условия, поэтому, если значение меньше наибольшего инварианта упорядочивания вставленного ключа, оно будет нарушено. Эта функция немного более эффективна, чем использование «insert_before». Это низкоуровневая функция, которая используется только для повышения производительности продвинутыми пользователями.

  28. <
    voidpush_front(referencevalue);
    >

    Требуется: Значение должно быть lvalue, и оно не должно быть больше минимального вставленного ключа

    Эффекты: Вставьте x в контейнер в первом положении.

    Сложность:

    Бросает: Ничего.

    Примечание: Эта функция не проверяет предварительные условия, поэтому, если значение больше минимального инварианта вставленного ключевого контейнера будет нарушено. Эта функция немного более эффективна, чем использование «insert_before». Это низкоуровневая функция, которая используется только для повышения производительности продвинутыми пользователями.

  29. <
    iteratorerase(const_iteratori);
    >

    Эффекты: Стирает элемент, на который указывает i.

    Сложность: Средняя сложность для элемента стирания — постоянное время.

    Бросок: Ничего.

    Примечание: Инвалидирует итераторы (но не ссылки) на стертые элементы. Деструкторы не называются.

  30. <
    iteratorerase(const_iteratorb,const_iteratore);
    >

    Эффекты: Уничтожает диапазон, указанный на b-конце e.

    Сложность: Средняя сложность для диапазона стирания составляет максимум O(log(size() + N)), где N - число элементов в диапазоне.

    Броски: Ничего.

    Примечание: Инвалидирует итераторы (но не ссылки) на стертые элементы. Деструкторы не называются.

  31. <
    size_typeerase(constkey_type&key);
    >

    Эффекты: Стирает все элементы с заданным значением.

    Возврат: Количество стертых элементов.

    Сложность: O(log(size() + N)

    Броски: Ничего.

    Примечание: Инвалидирует итераторы (но не ссылки) на стертые элементы. Деструкторы не называются.

  32. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     size_typeerase(constKeyType&key,KeyTypeKeyComparecomp);
    >

    Требуется: Ключ - это значение, такое, что<*this>разделено по отношению к comp(nk, key) и !comp(key, nk), причем comp(nk, key) подразумевает !comp(key, nk), причем nk ключ_тип значения_type вставлен в<*this>.

    Эффекты: Стирает все элементы заданным ключом. Согласно сравнительным функтора "комп."

    Возвращение: Количество стертых элементов.

    Сложность: O(log(size() + N)

    Броски: Ничего.

    Примечание: Инвалидирует итераторы (но не ссылки) на стертые элементы. Деструкторы не называются.

  33. <
    template<typenameDisposer>
     iteratorerase_and_dispose(const_iteratori,Disposerdisposer);
    >

    Требует: Диспетчер::оператор()(указатель) не должен бросать.

    Эффекты: Стирает элемент, на который указывает i. Утилизатор::оператор()(указатель) вызывается для удаленного элемента.

    Сложность: Средняя сложность для элемента стирания — постоянное время.

    Бросок: Ничего.

    Примечание: Инвалидирует итераторы на стертые элементы.

  34. <
    template<typenameDisposer>
     iteratorerase_and_dispose(const_iteratorb,const_iteratore,
                                Disposerdisposer);
    >

    Требует: Диспетчер::оператор()(указатель) не должен бросать.

    Эффекты: Уничтожает диапазон, указанный на b-конце e. Утилизатор::оператор()(указатель) вызывается для удаленных элементов.

    Сложность: Средняя сложность для диапазона стирания составляет максимум O(log(size() + N)), где N - число элементов в диапазоне.

    Броски: Ничего.

    Примечание: Инвалидирует итераторы на стертые элементы.

  35. <
    template<typenameDisposer>
     size_typeerase_and_dispose(constkey_type&key,Disposerdisposer);
    >

    Требует: Диспетчер::оператор()(указатель) не должен бросать.

    Эффекты: Стирает все элементы с заданным значением. Диспозитор::оператор()(указатель) вызывается для удаленных элементов.

    Возвращение: Количество стертых элементов.

    Сложность: O(log(size() + N)

    Бросок: Ничего.

    Примечание: Инвалидирует итераторы (но не ссылки) на стертые элементы. Деструкторы не называются.

  36. <
    template<typenameKeyType,typenameKeyTypeKeyCompare,typenameDisposer>
     size_typeerase_and_dispose(constKeyType&key,KeyTypeKeyComparecomp,
                                 Disposerdisposer);
    >

    Требуется: Ключ — это такое значение, что<*this>разбивается по отношению к comp(nk, key) и !comp(key, nk), причем comp(nk, key) подразумевает !comp(key, nk) и nk ключ_тип значения_типа, вставленный в<*this>.

    Требует: Диспетчер::оператор()(указатель) не должен бросать.

    Эффекты: Стирает все элементы заданным ключом. по сравнению с функтором «комп». Диспозитор::оператор()(указатель) вызывается для удаленных элементов.

    Возвращение: Количество стертых элементов.

    Сложность: O(log(size() + N)

    Броски: Ничего.

    Примечание: Инвалидирует итераторы на стертые элементы.

  37. <
    voidclear();
    >

    Эффекты: Стирает все элементы.

    Сложность: Линейный по количеству элементов на контейнере. Если это безопасный режим или авто-разъединить значение_тип. Постоянное время иначе.

    Бросает: Ничего.

    Примечание: Инвалидирует итераторы (но не ссылки) на стертые элементы. Деструкторы не называются.

  38. <
    template<typenameDisposer>voidclear_and_dispose(Disposerdisposer);
    >

    Эффекты: Стирает все элементы, вызывающие диспергатор (p), чтобы каждый узел был стерт.Сложность: Средняя сложность составляет максимум O(log(size()+N)), где N - количество элементов в контейнере.

    Бросок: Ничего.

    Примечание: Инвалидирует итераторы (но не ссылки) на стертые элементы. Звонки N раз для удаления функтора.

  39. <
    size_typecount(constkey_type&key)const;
    >

    Эффекты: Возвращает число содержащихся элементов с заданным значением

    Сложность: Логарифмическое к числу содержащихся элементов плюс линейное к числу объектов с заданным значением.

    Бросок: Если<key_compare>бросок.

  40. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     size_typecount(constKeyType&key,KeyTypeKeyComparecomp)const;
    >

    Требуется: Ключ - это значение, такое, что<*this>разделено относительно comp(nk, key) и !comp(key, nk), причем comp(nk, key) подразумевает !comp(key, nk), а nk - ключ_тип значения_типа, вставленный в<*this>.

    Эффекты: Возвращает число содержащихся элементов с заданным ключом

    Сложность: Логарифмическое к числу содержащихся элементов плюс линейное к числу объектов с заданным ключом.

    Броски: Если<comp>бросок.

  41. <
    iteratorlower_bound(constkey_type&key);
    >

    Эффекты: Возвращает итератор к первому элементу, ключ которого не меньше k или конца (), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<key_compare>бросок.

  42. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     iteratorlower_bound(constKeyType&key,KeyTypeKeyComparecomp);
    >

    Эффекты: Возвращает итератор к первому элементу, ключ которого не меньше k или конца(), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<key_compare>бросит

  43. <
    const_iteratorlower_bound(constkey_type&key)const;
    >

    Эффекты: Возвращает итератор к первому элементу, ключ которого не меньше k или конца(), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<key_compare>бросит

  44. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     const_iterator
     lower_bound(constKeyType&key,KeyTypeKeyComparecomp)const;
    >

    Эффекты: Возвращает итератор к первому элементу, ключ которого не меньше k или конца (), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<key_compare>бросит

  45. <
    iteratorupper_bound(constkey_type&key);
    >

    Эффекты: Возвращает итератор к первому элементу, ключ которого больше k или конца(), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<key_compare>бросок.

  46. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     iteratorupper_bound(constKeyType&key,KeyTypeKeyComparecomp);
    >

    Требуется: Ключ является значением, таким, что<*this>разделен относительно !comp(ключ, nk), с nk ключ_тип значения_тип вставлен в<*this>.

    Эффекты: Возвращает итератор к первому элементу, чей ключ больше k согласно comp или end(), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<comp>бросит.

  47. <
    const_iteratorupper_bound(constkey_type&key)const;
    >

    Эффекты: Возвращает итератор к первому элементу, ключ которого больше k или конца(), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<key_compare>бросит.

  48. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     const_iterator
     upper_bound(constKeyType&key,KeyTypeKeyComparecomp)const;
    >

    Требуется: Ключ — это такое значение, что<*this>разбивается на !comp(ключ, nk), при этом nk ключ_тип значения_тип вставляется в<*this>.

    Эффекты: Возвращает итератор к первому элементу, ключ которого больше k по компу или концу(), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<comp>бросит

  49. <
    iteratorfind(constkey_type&key);
    >

    Эффекты: Найден итератор первого элемента, ключом которого является k или конец(), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<key_compare>бросит.

  50. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     iteratorfind(constKeyType&key,KeyTypeKeyComparecomp);
    >

    Требуется: Ключ - это значение, такое, что<*this>разделено по отношению к comp(nk, key) и !comp(key, nk), причем comp(nk, key) подразумевает !comp(key, nk), и nk ключ_тип значения_type вставлен в<*this>.

    Эффекты: Найден итератор к первому элементу, ключ которого k или конец(), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросок: Если<comp>бросит.

  51. <
    const_iteratorfind(constkey_type&key)const;
    >

    Эффекты: Найден итератор к первому элементу, ключ которого k или конец(), если этот элемент не существует.

    Сложность: Логарифмический.

    Броски: Если<key_compare>бросит

  52. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     const_iteratorfind(constKeyType&key,KeyTypeKeyComparecomp)const;
    >

    Требуется: ключ является таким значением, что<*this>разбивается по отношению к comp(nk, key) и !comp(key, nk), причем comp(nk, key) подразумевает !comp(key, nk), а nk ключ_тип значения_type вставляется в<*this>.

    Эффекты: Найден итератор к первому элементу, ключ которого k или конец(), если этот элемент не существует.

    Сложность: Логарифмический.

    Бросает: Если<comp>бросит.

  53. <
    std::pair<iterator,iterator>equal_range(constkey_type&key);
    >

    Эффекты: Найден диапазон, содержащий все элементы, ключ которых k или пустой диапазон, который указывает положение, в котором эти элементы были бы, если бы у них не было элементов с ключом k.

    Сложность: Логарифмический.

    Броски: Если<key_compare>бросит.

  54. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     std::pair<iterator,iterator>
     equal_range(constKeyType&key,KeyTypeKeyComparecomp);
    >

    Требуется: Ключ - это значение, такое, что<*this>разделено по отношению к comp(nk, key) и !comp(key, nk), с comp(nk, key), подразумевающим !comp(key, nk), с nk ключ_тип значения_type вставлен в<*this>.

    : Найден диапазон, содержащий все элементы, ключ которых k или пустой диапазон, который указывает положение, в котором эти элементы были бы, если бы у них не было элементов с ключом k.

    Сложность: Логарифмический.

    Броски: Если бросит<comp>.

  55. <
    std::pair<const_iterator,const_iterator>
    equal_range(constkey_type&key)const;
    >

    Эффекты: Найден диапазон, содержащий все элементы, ключ которых k или пустой диапазон, который указывает положение, в котором эти элементы были бы, если бы у них не было элементов с ключом k.

    Сложность: Логарифмический.

    Бросок: Если<key_compare>бросит

  56. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     std::pair<const_iterator,const_iterator>
     equal_range(constKeyType&key,KeyTypeKeyComparecomp)const;
    >

    Требуется: Ключ — это такое значение, что<*this>разбивается по отношению к comp(nk, key) и !comp(key, nk), при этом comp(nk, key) подразумевает !comp(key, nk), при этом nk вставляется в<*this>ключ_тип значения_типа

    Эффекты: Найден диапазон, содержащий все элементы, ключ которых k или пустой диапазон, который указывает положение, в котором эти элементы были бы, если бы у них не было элементов с ключом k.

    Сложность: Логарифмический.

    Бросок: Если бросит<comp>.

  57. <
    std::pair<iterator,iterator>
    bounded_range(constkey_type&lower_key,constkey_type&upper_key,
                 boolleft_closed,boolright_closed);
    >

    Требует:<upper_key>не должен предшествовать<lower_key>в соответствии с key_compare.

    Если<lower_key>эквивалентно<upper_key>[!key_comp() [!key_comp() [!upper_key, lower_key) && !key_comp() [(lower_key, upper_key)] тогда ['left_closed' | | 'right_closed'] должно быть ложным.

    Эффекты[] : Возвращает пару со следующими критериями:

    первый = нижний_связанный (нижний_ключ), если левый_закрытый, верхний_связанный (нижний_ключ) в противном случае

    второй = верхний_связанный (верхний_ключ), если правый_закрытый, нижний_связанный (верхний_ключ) в противном случае

    : Логарифмический.

    Броски: Если<key_compare>бросает.

    Примечание: Эта функция может быть более эффективной, чем вызов верхнего и нижнего пределов для нижнего и верхнего значений.

    Примечание: Экспериментальная функция, интерфейс может измениться в будущих выпусках.

  58. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     std::pair<iterator,iterator>
     bounded_range(constKeyType&lower_key,constKeyType&upper_key,
                   KeyTypeKeyComparecomp,boolleft_closed,boolright_closed);
    >

    Требует:<lower_key>является значением, таким, что<*this>разбивается по отношению к comp(nk, lower_key), если Left_closed истинно, по отношению к !comp(lower_key, nk) иначе.

    <upper_key>является значением, таким, что<*this>разбивается по отношению к !comp(upper_key, nk), если право_closed истинно, по отношению к comp(nk, upper_key) иначе.

    <upper_key>не должен предшествовать<lower_key>в соответствии с Comp [comp(upper_key, lower_key) должен быть ложным]

    Если<lower_key>эквивалентно<upper_key>[!comp(upper_key, lower_key) && !comp(lower_key, upper_key)], то ('left_closed' | | 'right_closed') должно быть ложным.

    Эффекты: Возвращает пару со следующими критериями:

    первый = нижний_bound(lower_key, comp) при левом_закрытом, верхний_bound(lower_key, comp) в противном случае

    второй = верхний_bound(upper_key, comp) при правом_закрытом, нижний_bound(upper_key, comp) в противном случае

    : Логарифмический.

    Бросок: Если<comp>бросает.

    Примечание: Эта функция может быть более эффективной, чем вызов top_bound и lower_bound для low_key и upper_key.

    Примечание: Экспериментальная функция, интерфейс может измениться в будущих выпусках.

  59. <
    std::pair<const_iterator,const_iterator>
    bounded_range(constkey_type&lower_key,constkey_type&upper_key,
                 boolleft_closed,boolright_closed)const;
    >

    Требует:<upper_key>не должен предшествовать<lower_key>в соответствии с key_compare. [key_comp()(upper_key, lower_key) должен быть ложным]

    Если<lower_key>эквивалентно<upper_key>[!key_comp()(upper_key, lower_key) && !key_comp()(lower_key, upper_key)], то ('left_closed' | | 'right_closed') должно быть ложным.

    Эффекты: Возвращает пару со следующими критериями:

    первый = нижний_связанный (нижний_ключ), если левый_закрытый, верхний_связанный (нижний_ключ) в противном случае

    второй = верхний_связанный (верхний_ключ), если правый_закрытый, нижний_связанный (верхний_ключ) в противном случае

    : Логарифмический.

    Бросок: Если<key_compare>бросит.

    Примечание: Эта функция может быть более эффективной, чем вызов верхнего и нижнего пределов для нижнего и верхнего значений.

    Примечание: Экспериментальная функция, интерфейс может измениться в будущих выпусках.

  60. <
    template<typenameKeyType,typenameKeyTypeKeyCompare>
     std::pair<const_iterator,const_iterator>
     bounded_range(constKeyType&lower_key,constKeyType&upper_key,
                   KeyTypeKeyComparecomp,boolleft_closed,boolright_closed)const;
    >

    :<lower_key>является значением, таким, что<*this>разделен по отношению к comp(nk, low_key, nk) в противном случае, по отношению к !comp(lower_key, nk)

    <*this>по отношению к !comp(upper_key, nk) по отношению к !comp(upper_key, nk) по отношению к !comp(upper_key, nk) по отношению к !comp(upper_key, upper_key) в противном случае

    <upper_key>по отношению к comp [comp(upper_key, lower_key) не должен предшествовать<lower_key>по отношению к comp [comp(upper_key, lower_key)

    Если<lower_key>эквивалентен<upper_key>[!comp(upper_key, lower_key) && !comp(lower_key, upper_key)

    Эффекты: Возвращает пару со следующими критериями:

    первый = нижний_bound(lower_key, comp) при левом_закрытом, верхний_bound(lower_key, comp) в противном случае

    второй = верхний_bound(upper_key, comp) при правом_закрытом, нижний_bound(upper_key, comp) в противном случае

    : Логарифмический.

    Броски: Если<comp>бросает.

    Примечание: Эта функция может быть более эффективной, чем вызов top_bound и lower_bound для low_key и upper_key.

    Примечание: Экспериментальная функция, интерфейс может измениться в будущих выпусках.

  61. <
    iteratoriterator_to(referencevalue);
    >

    Требуется: Значение должно быть lvalue и должно быть в наборе соответствующего типа. В противном случае поведение не определено.

    Эффекты: Возврат: действительный итератор i, относящийся к набору, который указывает на значение

    Сложность: Константа.

    Броски: Ничего.

  62. <
    const_iteratoriterator_to(const_referencevalue)const;
    >

    Требуется: Значение должно быть lvalue и должно быть в наборе соответствующего типа. В противном случае поведение не определено.

    Эффекты: Возврат: действительный const_iterator i, принадлежащий множеству, которое указывает на значение

    Сложность: Константа.

    Броски: Ничего.

  63. <
    pointerunlink_leftmost_without_rebalance();
    >

    Эффекты: Отсоединяет самый левый узел контейнера.

    Сложность: Средняя сложность — это постоянное время.

    Броски: Ничего.

    Примечания: Эта функция разрушает контейнер, и контейнер может использоваться только для дополнительных вызовов unlink_leftmost_without_rebalance. Эта функция обычно используется для достижения поэтапного контролируемого разрушения контейнера.

  64. <
    voidreplace_node(iteratorreplace_this,referencewith_this);
    >

    Требуется: Заменить_это должен быть действительный итератор *это и с_это не должно быть вставлено в любой контейнер.

    Эффекты: Заменяет замену_this в своем положении в контейнере с_this. Контейнер не нужно перебалансировать.

    Сложность:

    Бросает: Ничего.

    Примечание: Эта функция будет нарушать инварианты заказа контейнера, если с_это не эквивалентно *заменить_это в соответствии с правилами заказа. Эта функция быстрее, чем стирание и вставка узла, так как не требуется перебалансировка или сравнение.

  65. <
    voidremove_node(referencevalue);
    >

    Эффекты: удаляет «значение» из контейнера.

    Бросок: Ничего.

    Сложность: Логарифмическое время.

    Примечание: Эта статическая функция может использоваться только в непостоянных контейнерах с размером времени, которые имеют функторы сравнения без состояния.

    Если пользователь называет эту функцию контейнером с постоянным размером времени или функтором сравнения состояния, будет выпущена ошибка компиляции.

  66. <
    template<class...Options2>voidmerge(bs_multiset<T,Options2...>&source);
    >

    Требуется: Варианты контейнера "источник" могут отличаться только функцией сравнения от *этого.

    Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *это.

    Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в это, а не в источник.

    Броски: Ничего, если объект сравнения не бросит.

    Сложность: N log(a.size() + N) (N имеет значение source.size())

  67. <
    template<class...Options2>voidmerge(bs_set<T,Options2...>&source);
    >

    Требуется: Варианты контейнера "источник" могут отличаться только функцией сравнения от *этого.

    Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *это.

    Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в это, а не в источник.

    Броски: Ничего, если объект сравнения не бросит.

    Сложность: N log(a.size() + N) (N имеет значение source.size())

bs_multiset public static functions

  1. <
    staticbs_multiset&container_from_end_iterator(iteratorend_iterator);
    >

    Предварительное условие: end_iterator должен быть действительным конечным итератором контейнера.

    Эффекты: Возвращает конст-ссылку на контейнер, связанный с конечным итератором

    Бросает: Ничего.

    Сложность: Постоянная.

  2. <
    staticconstbs_multiset&
    container_from_end_iterator(const_iteratorend_iterator);
    >

    Предварительное условие: end_iterator должен быть действительным конечным итератором контейнера.

    Эффекты: Возвращает ссылку на контейнер, связанный с конечным итератором

    Бросает: Ничего.

    Сложность: Постоянная.

  3. <
    staticbs_multiset&container_from_iterator(iteratorit);
    >

    Предварительное условие: он должен быть действительным итератором контейнера.

    Эффекты: Возвращает ссылку на контейнер, связанный с итератором

    Бросает: Ничего.

    Сложность: Логарифмический.

  4. <
    staticconstbs_multiset&container_from_iterator(const_iteratorit);
    >

    Предварительное условие: он должен быть действительным итератором контейнера.

    Эффекты: Возвращает ссылку на контейнер, связанный с итератором

    Бросает: Ничего.

    Сложность: Логарифмический.

  5. <
    staticiterators_iterator_to(referencevalue);
    >

    Требуется: Значение должно быть lvalue и должно быть в наборе соответствующего типа. Иначе поведение не определено.

    Эффекты: Возврат: действительный итератор i, относящийся к набору, который указывает на значение

    Сложность: Констант.

    Броски: Ничего.

    Примечание: Эта статическая функция доступна только в том случае, если свойстване имеют состояния.

  6. <
    staticconst_iterators_iterator_to(const_referencevalue);
    >

    Требуется: Значение должно быть lvalue и должно быть в наборе соответствующего типа. В противном случае поведение не определено.

    Эффекты: Возврат: действительный итератор i, относящийся к набору, который указывает на значение

    Сложность: Констант.

    Броски: Ничего.

    Примечание: Эта статическая функция доступна только в том случае, если значенияне имеют состояния.

  7. <
    staticvoidinit_node(referencevalue);
    >

    Требует: Стоимость не должна находиться в контейнере.

    Эффекты: Init_node ставит крючок значения в известное состояние по умолчанию.

    Бросает: Ничего.

    Сложность: Постоянное время.

    Примечание: Эта функция помещает крюк в известное состояние по умолчанию, используемое auto_unlink и безопасными крючками.


PrevUpHomeNext

Статья Class template bs_multiset раздела The Boost C++ Libraries BoostBook Documentation Subset Reference может быть полезна для разработчиков на c++ и boost.




Материалы статей собраны из открытых источников, владелец сайта не претендует на авторство. Там где авторство установить не удалось, материал подаётся без имени автора. В случае если Вы считаете, что Ваши права нарушены, пожалуйста, свяжитесь с владельцем сайта.



:: Главная :: Reference ::


реклама


©KANSoftWare (разработка программного обеспечения, создание программ, создание интерактивных сайтов), 2007
Top.Mail.Ru

Время компиляции файла: 2024-08-30 11:47:00
2025-05-20 00:59:28/0.034094095230103/1