Class template multiset . Boost , The Boost C++ Libraries BoostBook Documentation Subset , Boost.Container Header Reference

Class template multiset

boost::container::multiset

Synopsis

// In header: <boost/container/set.hpp>
template<typename Key, typename Compare = std::less<Key>, 
         typename Allocator = new_allocator<Key>, 
         typename Options = tree_assoc_defaults> 
class multiset {
public:
  // types
  typedef Key                                                                key_type;              
  typedef Key                                                                value_type;            
  typedef Compare                                                            key_compare;           
  typedef Compare                                                            value_compare;         
  typedef ::boost::container::allocator_traits< Allocator >                  allocator_traits_type; 
  typedef ::boost::container::allocator_traits< Allocator >::pointer         pointer;               
  typedef ::boost::container::allocator_traits< Allocator >::const_pointer   const_pointer;         
  typedef ::boost::container::allocator_traits< Allocator >::reference       reference;             
  typedef ::boost::container::allocator_traits< Allocator >::const_reference const_reference;       
  typedef ::boost::container::allocator_traits< Allocator >::size_type       size_type;             
  typedef ::boost::container::allocator_traits< Allocator >::difference_type difference_type;       
  typedef Allocator                                                          allocator_type;        
  typedef implementation_defined                                             stored_allocator_type; 
  typedef implementation_defined                                             iterator;              
  typedef implementation_defined                                             const_iterator;        
  typedef implementation_defined                                             reverse_iterator;      
  typedef implementation_defined                                             const_reverse_iterator;
  typedef implementation_defined                                             node_type;             
  // construct/copy/destruct
  multiset() noexcept(container_detail::is_nothrow_default_constructible< Allocator >::value &&container_detail::is_nothrow_default_constructible< Compare >::value));
  explicit multiset(const Compare &, 
                    const allocator_type & = allocator_type());
  explicit multiset(const allocator_type &);
  template<typename InputIterator> 
    multiset(InputIterator, InputIterator, const Compare & = Compare(), 
             const allocator_type & = allocator_type());
  template<typename InputIterator> 
    multiset(InputIterator, InputIterator, const allocator_type &);
  template<typename InputIterator> 
    multiset(ordered_range_t, InputIterator, InputIterator, 
             const Compare & = Compare(), 
             const allocator_type & = allocator_type());
  multiset(std::initializer_list< value_type >, const Compare & = Compare(), 
           const allocator_type & = allocator_type());
  multiset(std::initializer_list< value_type >, const allocator_type &);
  multiset(ordered_unique_range_t, std::initializer_list< value_type >, 
           const Compare & = Compare(), 
           const allocator_type & = allocator_type());
  multiset(const multiset &);
  multiset(multiset &&) noexcept(boost::container::container_detail::is_nothrow_move_constructible< Compare >::value));
  multiset(const multiset &, const allocator_type &);
  multiset(multiset &&, const allocator_type &);
  multiset & operator=(const multiset &);
  multiset & operator=(multiset &&) noexcept((allocator_traits_type::propagate_on_container_move_assignment::value||allocator_traits_type::is_always_equal::value)&&boost::container::container_detail::is_nothrow_move_assignable< Compare >::value));
  multiset & operator=(std::initializer_list< value_type >);
  // public member functions
  allocator_type get_allocator() const;
  stored_allocator_type & get_stored_allocator();
  const stored_allocator_type & get_stored_allocator() const;
  iterator begin();
  const_iterator begin() const;
  const_iterator cbegin() const;
  iterator end() noexcept;
  const_iterator end() const noexcept;
  const_iterator cend() const noexcept;
  reverse_iterator rbegin() noexcept;
  const_reverse_iterator rbegin() const noexcept;
  const_reverse_iterator crbegin() const noexcept;
  reverse_iterator rend() noexcept;
  const_reverse_iterator rend() const noexcept;
  const_reverse_iterator crend() const noexcept;
  bool empty() const;
  size_type size() const;
  size_type max_size() const;
  template<class... Args> iterator emplace(Args &&...);
  template<class... Args> iterator emplace_hint(const_iterator, Args &&...);
  iterator insert(const value_type &);
  iterator insert(value_type &&);
  iterator insert(const_iterator, const value_type &);
  iterator insert(const_iterator, value_type &&);
  template<typename InputIterator> void insert(InputIterator, InputIterator);
  void insert(std::initializer_list< value_type >);
  iterator insert(node_type &&);
  iterator insert(const_iterator, node_type &&);
  template<typename C2> void merge(multiset< Key, C2, Allocator, Options > &);
  template<typename C2> void merge(multiset< Key, C2, Allocator, Options > &&);
  template<typename C2> void merge(set< Key, C2, Allocator, Options > &);
  template<typename C2> void merge(set< Key, C2, Allocator, Options > &&);
  iterator erase(const_iterator);
  size_type erase(const key_type &);
  iterator erase(const_iterator, const_iterator);
  void swap(multiset &) noexcept(allocator_traits_type::is_always_equal::value &&boost::container::container_detail::is_nothrow_swappable< Compare >::value));
  void clear() noexcept;
  key_compare key_comp() const;
  value_compare value_comp() const;
  iterator find(const key_type &);
  const_iterator find(const key_type &) const;
  size_type count(const key_type &) const;
  iterator lower_bound(const key_type &);
  const_iterator lower_bound(const key_type &) const;
  iterator upper_bound(const key_type &);
  const_iterator upper_bound(const key_type &) const;
  std::pair< const_iterator, const_iterator > 
  equal_range(const key_type &) const;
  std::pair< iterator, iterator > equal_range(const key_type &);
  void rebalance();
  // friend functions
  friend bool operator==(const multiset &, const multiset &);
  friend bool operator!=(const multiset &, const multiset &);
  friend bool operator<(const multiset &, const multiset &);
  friend bool operator>(const multiset &, const multiset &);
  friend bool operator<=(const multiset &, const multiset &);
  friend bool operator>=(const multiset &, const multiset &);
  friend void swap(multiset &, multiset &);
};

Description

Мультисет - это своего рода ассоциативный контейнер, который поддерживает эквивалентные ключи (возможно, содержит несколько копий одного и того же значения ключа) и обеспечивает быстрое извлечение самих ключей. Класс Multiset поддерживает двунаправленные итераторы.

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

Template Parameters

```
typenameKey
```
- тип, который должен быть вставлен в набор, который также является ключевым_типом.
```
typenameCompare=std::less<Key>
```
— сравнительный функтор, используемый для заказа ключей.
```
typenameAllocator=new_allocator<Key>
```
является распределителем, используемым для выделения памяти для этого контейнера.
```
typenameOptions=tree_assoc_defaults
```
- упакованный тип опции, сгенерированный с использованиемboost::container::tree_assoc_options.

`multiset` public construct/copy/destruct

multiset()noexcept(container_detail::is_nothrow_default_constructible<Allocator>::value&&container_detail::is_nothrow_default_constructible<Compare>::value));

Эффекты: Дефолт создает пустой набор.

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

```
explicitmultiset(constCompare&comp,
                 constallocator_type&a=allocator_type());
```
Эффекты: Постраивает пустой набор с помощью указанного объекта сравнения и распределителя.
Сложность: Постоянно.
```
explicitmultiset(constallocator_type&a);
```
Эффекты: Постраивает пустой набор с помощью указанного объекта распределения.
Сложность: Постоянно.
```
template<typenameInputIterator>
 multiset(InputIteratorfirst,InputIteratorlast,
          constCompare&comp=Compare(),
          constallocator_type&a=allocator_type());
```
Эффекты: Постраивает пустой набор с помощью указанного объекта сравнения и распределителя и вставляет элементы из диапазона [первый, последний ].
Сложность: Линейный в N, если диапазон [первый, последний] уже отсортирован с использованием comp и иначе N logN, где N последний — первый.
```
template<typenameInputIterator>
 multiset(InputIteratorfirst,InputIteratorlast,constallocator_type&a);
```
Эффекты: Конструирует пустой набор с помощью указанного распределителя и вставляет элементы из диапазона [первый, последний ]
Сложность: Линейный в N, если диапазон [первый, последний] уже отсортирован с использованием comp и иначе N logN, где N последний — первый.
```
template<typenameInputIterator>
 multiset(ordered_range_t,InputIteratorfirst,InputIteratorlast,
          constCompare&comp=Compare(),
          constallocator_type&a=allocator_type());
```
Эффекты: Конструирует пустой мультисет с использованием указанного объекта сравнения и распределителя и вставляет элементы из упорядоченного диапазона [первый, последний ]. Эта функция более эффективна, чем создание нормального диапазона для упорядоченных диапазонов.
Требует: [первый, последний] должен быть упорядочен согласно предикату.
Сложность: Линейный в N.
Примечание: Нестандартное расширение.
```
multiset(std::initializer_list<value_type>il,
        constCompare&comp=Compare(),
        constallocator_type&a=allocator_type());
```
Эффекты: Конструирует пустой набор с использованием указанного объекта сравнения и распределителя и вставляет элементы из диапазона [il.begin(), il.end()).
Сложность: Линейный в N, если диапазон [il.begin(), il.end()) уже отсортирован с использованием comp и иначе N logN, где N - il.begin() - il.end().
Эффекты: Конструктивно-конструкторские работы в области мазь аллоцитара и торнадо в направлении [il.begin(), il.end())]
: Линейка N, [il.begin(), il.end()], [il.begin(), [il.end()], [il.begin()], [il.begin() - [il.end()]
[ORIG_END] -->
```
multiset(ordered_unique_range_t,std::initializer_list<value_type>il,
        constCompare&comp=Compare(),
        constallocator_type&a=allocator_type());
```
Эффекты: Конструирует пустой набор с использованием указанного объекта сравнения и распределителя и вставляет элементы из упорядоченного уникального диапазона [il.begin(), il.end()). Эта функция более эффективна, чем создание нормального диапазона для упорядоченных диапазонов.
Требует: [il.begin(), il.end()) должны быть упорядочены в соответствии с предикатом и должны быть уникальными значениями.
Сложность: Линейный в N.
Примечание: Нестандартное расширение.
```
multiset(constmultiset&x);
```
Эффекты: Копия конструирует множество.
Сложность: Линейный в x.size().
```
multiset(multiset&&x)noexcept(boost::container::container_detail::is_nothrow_move_constructible<Compare>::value));
```
Эффекты: Move создает набор. Конструирует это с использованием ресурсов x.
Сложность: Постоянная.
Посткондиционное состояние: x опустошается.
```
multiset(constmultiset&x,constallocator_type&a);
```
Эффекты: Копия конструирует набор с использованием указанного распределителя.
Сложность: Линейный в x.size().
Эффекты: Пересчитано по механической шкале.
] , == x.get_allocator(), линейный.
[ORIG_END] -->
```
multiset&operator=(constmultiset&x);
```
Эффекты: Делает это копией x.
Сложность: Линейный в x.size().
```
multiset&operator=(multiset&&x)noexcept((allocator_traits_type::propagate_on_container_move_assignment::value||allocator_traits_type::is_always_equal::value)&&boost::container::container_detail::is_nothrow_move_assignable<Compare>::value));
```
Эффекты:
Бросок: Если Allocator_traits_type::propagate_on_container_move_assignment является ложным и (броски распределения или броски конструктора движения Value_type)
Сложность: Постоянная, если allocator_traits_type:: propagate_on_container_move_assignment является истинным или это->get>allocator() == x.get_allocator(). Линейное иначе.
```
multiset&operator=(std::initializer_list<value_type>il);
```
Эффекты: Копировать все элементы от il до *this.
Сложность: Линейный в il.size().

multiset public member functions

allocator_typeget_allocator()const;
Эффекты: Возвращает копию распределителя, которая была передана конструктору объекта.
Сложность: Постоянная.
stored_allocator_type&get_stored_allocator();
: Возвращает ссылку на внутренний распределитель.
Броски: Ничто
Сложность: Константа.
Примечание: Нестандартное расширение.
conststored_allocator_type&get_stored_allocator()const;
Эффекты: Возвращает ссылку на внутренний распределитель.
Бросает: Ничто
Сложность: Константа.
Примечание: Нестандартное расширение.
iteratorbegin();
Эффекты: возвращает итератор к первому элементу, содержащемуся в контейнере.
Бросок: Ничего.
Сложность: Постоянство
const_iteratorbegin()const;
Эффекты: Возвращает const_iterator к первому элементу контейнера.
Бросок: Ничего.
Сложность: Постоянно.
const_iteratorcbegin()const;
Эффекты: Возвращает const_iterator к первому элементу контейнера.
Бросок: Ничего.
Сложность: Постоянная.
iteratorend()noexcept;
Эффекты: Возвращает итератор в конец контейнера.
Бросок: Ничего.
Сложность: Постоянная.
Эффекты:
Бросает: Ничего.
[ORIG_END] -->
const_iteratorcend()constnoexcept;
Эффекты: Возвращает const_iterator в конец контейнера.
Бросает: Ничего.
Сложность: Постоянная.
reverse_iteratorrbegin()noexcept;
Эффекты: Возвращает обратный_iterator, указывающий на начало обратного контейнера.
Бросок: Ничего.
Сложность: Постоянная.
const_reverse_iteratorrbegin()constnoexcept;
Эффекты: Возвращает const_reverse_iterator, указывающий на начало обратного контейнера.
Бросок: Ничего.
Сложность: Постоянная.
const_reverse_iteratorcrbegin()constnoexcept;
Эффекты: Возвращает const_reverse_iterator, указывающий на начало обратного контейнера.
Бросок: Ничего.
Сложность: Постоянная.
reverse_iteratorrend()noexcept;
Эффекты: Возвращает обратный_iterator, указывающий на конец обратного контейнера.
Бросок: Ничего.
Сложность: Постоянная.
Эффекты: Описание
Броски: Ничего.
[ORIG_END] -->
const_reverse_iteratorcrend()constnoexcept;
Эффекты: Возвращает const_reverse_iterator, указывающий на конец обратного контейнера.
Бросок: Ничего.
Сложность: Постоянная.
boolempty()const;
Эффекты: Возвращается, если контейнер не содержит элементов.
Бросок: Ничего.
Сложность: Постоянная.
size_typesize()const;
Эффекты: Возвращает количество элементов, содержащихся в контейнере.
Бросок: Ничего.
Сложность: Постоянно.
size_typemax_size()const;
Эффекты: Возвращает максимально возможный размер контейнера.
Бросок: Ничего.
Сложность: Постоянная.
template<class...Args>iteratoremplace(Args&&...args);
Эффекты: Вставляет объект типа Key, построенный с помощью std::forward(args)... и возвращает итератор, указывающий на вновь вставленный элемент.
Сложность: Логарифмический.
template<class...Args> iteratoremplace_hint(const_iteratorp,Args&&...args);
Эффекты: Вставляет объект типа Key, построенный с помощью std::forward(args)...
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным ключу x.
Сложность: Логарифмическая в целом, но амортизированная постоянная, если t вставлено непосредственно перед p.
iteratorinsert(constvalue_type&x);
Эффекты: Вставляет x и возвращает итератор, указывающий на вновь вставленный элемент.
Сложность: Логарифмический.
iteratorinsert(value_type&&x);
Эффекты: Вставьте копию x в контейнер.
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным ключу x.
Сложность: Логарифмическая в целом, но амортизированная постоянная, если t вставлено непосредственно перед p.
iteratorinsert(const_iteratorp,constvalue_type&x);
Эффекты: Вставьте копию x в контейнер. p - подсказка, указывающая, где вставка должна начать поиск.
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным ключу x.
Сложность: Логарифмическая в целом, но амортизированная постоянная, если t вставлено непосредственно перед p.
iteratorinsert(const_iteratorp,value_type&&x);
Эффекты: Вставляет движение значения, построенное из x в контейнере. p - подсказка, указывающая, где вставка должна начать поиск.
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным ключу x.
Сложность: Логарифмическая в целом, но амортизированная постоянная, если t вставлено непосредственно перед p.
template<typenameInputIterator> voidinsert(InputIteratorfirst,InputIteratorlast);
Требуется: Во-первых, последние не являются итераторами в *это.
Эффекты: вставляет каждый элемент из диапазона [первый, последний]
Сложность: N log(size()+N) (N - расстояние от первого до последнего)
voidinsert(std::initializer_list<value_type>il);
Эффекты: вставляет каждый элемент из диапазона [il.begin(),il.end()) если и только если нет элемента с ключом, эквивалентным ключу этого элемента.
Сложность: N log(size()+N) (N — расстояние от il.begin() до il.end())
Эффекты: Крупногабаритный
: Логарифмический.
[ORIG_END] -->
iteratorinsert(const_iteratorhint,node_type&&nh);
Эффекты: Вставляет новое значение движения, построенное из x в контейнере. p - подсказка, указывающая, где вставка должна начать поиск.
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным ключу x.
Сложность: Логарифмическая в целом, но амортизированная постоянная, если t вставлено непосредственно перед p.
template<typenameC2> voidmerge(multiset<Key,C2,Allocator,Options>&source);
Требуется: это->get_allocator() == source.get_allocator().
Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *это.
Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в это, а не в источник.
Бросок: Ничего, если объект сравнения не бросит.
Сложность: N log(a.size() + N) (N имеет значение source.size())
template<typenameC2> voidmerge(multiset<Key,C2,Allocator,Options>&&source);
Требуется: это->get_allocator() == source.get_allocator().
Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *this.
Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в это, а не в источник.
Бросок: Ничего, если объект сравнения не бросит.
Сложность: N log(a.size() + N) (N имеет значение source.size())
template<typenameC2>voidmerge(set<Key,C2,Allocator,Options>&source);
Требуется: это->get_allocator() == source.get_allocator().
Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *это.
Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в это, а не в источник.
Бросок: Ничего, если объект сравнения не бросит.
Сложность: N log(a.size() + N) (N имеет значение source.size())
template<typenameC2>voidmerge(set<Key,C2,Allocator,Options>&&source);
Требуется: это->get_allocator() == source.get_allocator().
Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *this.
Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в * это, а не в источник.
Бросает: Ничего, если объект сравнения не бросает.
Сложность: N log(a.size() + N) (N имеет значение source.size())
iteratorerase(const_iteratorp);
Эффекты: Стирает элемент, указанный p.
Возвращает: Возвращает итератор, указывающий на элемент непосредственно после q перед стиранием элемента. Если такого элемента не существует, возвращается конец ().
Сложность: Амортизированное постоянное время
size_typeerase(constkey_type&x);
Эффекты: Стирает все элементы в контейнере с ключом, эквивалентным x.
Возвращает: Возвращает количество стертых элементов.
Сложность: log(size()) + count(k)
iteratorerase(const_iteratorfirst,const_iteratorlast);
Эффекты: Стирает все элементы в диапазоне [первый, последний].
Возвращение:
Сложность: log(size())+ где N - расстояние от первого до последнего.
voidswap(multiset&x)noexcept(allocator_traits_type::is_always_equal::value&&boost::container::container_detail::is_nothrow_swappable<Compare>::value));
Эффекты: Изменяет содержание *это и x.
Бросает: Ничего.
Сложность: Постоянная.
voidclear()noexcept;
Эффекты: стирание (a.begin(),a.end()).
Посткондиция: размер() == 0.
Сложность: линейный размер().
key_comparekey_comp()const;
Эффекты: Возвращает объект сравнения, из которого был построен объект сравнения.
Сложность: Постоянная.
value_comparevalue_comp()const;
Эффекты: Возвращает объект value_compare, построенный из объекта сравнения.
Сложность: Постоянная.

Возвращение: Итерштор, форс-мажор, элемент ключа, эквивалент x, или см.
Логарифмический.
[ORIG_END] -->
```
const_iteratorfind(constkey_type&x)const;
```
Возвращение: Const_iterator, указывающий на элемент с ключом, эквивалентным x, или конец(), если такой элемент не найден.
Сложность: Логарифмический.
```
size_typecount(constkey_type&x)const;
```
Возвращение: Число элементов с ключом, эквивалентным x.
Сложность: log(size())+count(k)
```
iteratorlower_bound(constkey_type&x);
```
Возвращение: Итератор, указывающий на первый элемент с ключом не менее k, или a.end(), если такой элемент не найден.
Сложность: Логарифмический
```
const_iteratorlower_bound(constkey_type&x)const;
```
Возвращение: Конст-итератор, указывающий на первый элемент с ключом не менее k, или a.end(), если такой элемент не найден.
Сложность: Логарифмический
```
iteratorupper_bound(constkey_type&x);
```
Возвращение: Итератор, указывающий на первый элемент с ключом не менее x, или конец(), если такой элемент не найден.
Сложность: Логарифмический
Возвращение: Исследовать право и причинить вред, установив, что
[ORIG_END] -->
```
std::pair<const_iterator,const_iterator>
equal_range(constkey_type&x)const;
```
Эффекты: Эквивалент std::make_pair(this->lower_bound(k), this->upper_bound(k)).
Сложность: Логарифмический
```
std::pair<iterator,iterator>equal_range(constkey_type&x);
```
Эффекты: Эквивалент std::make_pair(this->lower_bound(k), this->upper_bound(k)).
Сложность: Логарифмический
```
voidrebalance();
```
Эффекты: Уравновешивает дерево. Это не опция для красно-черных и AVL деревьев.
Сложность: Линейный

`multiset` friend functions

```
friendbooloperator==(constmultiset&x,constmultiset&y);
```
Эффекты: Возвращается истинно, если x и y равны
Сложность: Линейный по количеству элементов в контейнере.
```
friendbooloperator!=(constmultiset&x,constmultiset&y);
```
Эффекты: Верно, если x и y неравны
Сложность: Линейный по количеству элементов в контейнере.
```
friendbooloperator<(constmultiset&x,constmultiset&y);
```
Эффекты: Верно, если x меньше y
Сложность: Линейный по количеству элементов в контейнере.
```
friendbooloperator>(constmultiset&x,constmultiset&y);
```
Эффекты: Верно, если x больше y
Сложность: Линейный по количеству элементов в контейнере.
```
friendbooloperator<=(constmultiset&x,constmultiset&y);
```
Эффекты: Верно, если x равно или меньше y
Сложность: Линейный по количеству элементов в контейнере.
```
friendbooloperator>=(constmultiset&x,constmultiset&y);
```
Эффекты: Возвращается истинно, если x равно или больше y
Сложность: Линейный по количеству элементов в контейнере.
```
friendvoidswap(multiset&x,multiset&y);
```
Эффекты: x.swap(y)
Сложность: Постоянная.

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

Class template multiset

Boost , The Boost C++ Libraries BoostBook Documentation Subset , Boost.Container Header Reference

Boost C++ Libraries

Class template multiset

Synopsis

Description

Template Parameters

multiset public construct/copy/destruct

multiset public member functions

multiset friend functions

`multiset` public construct/copy/destruct

`multiset` public member functions

`multiset` friend functions