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

Class template flat_multimap

boost::container::flat_multimap

Synopsis

// In header: <boost/container/flat_map.hpp>
template<typename Key, typename T, typename Compare = std::less<Key>, 
         typename Allocator = new_allocator< std::pair< Key, T> > > 
class flat_multimap {
public:
  // types
  typedef Key                                                              key_type;              
  typedef T                                                                mapped_type;           
  typedef std::pair< Key, T >                                              value_type;            
  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                                           value_compare;         
  typedef Compare                                                          key_compare;           
  typedef implementation_defined                                           iterator;              
  typedef implementation_defined                                           const_iterator;        
  typedef implementation_defined                                           reverse_iterator;      
  typedef implementation_defined                                           const_reverse_iterator;
  typedef implementation_defined                                           movable_value_type;    
  // construct/copy/destruct
  flat_multimap() noexcept(container_detail::is_nothrow_default_constructible< Allocator >::value &&container_detail::is_nothrow_default_constructible< Compare >::value));
  explicit flat_multimap(const Compare &, 
                         const allocator_type & = allocator_type());
  explicit flat_multimap(const allocator_type &);
  template<typename InputIterator> 
    flat_multimap(InputIterator, InputIterator, const Compare & = Compare(), 
                  const allocator_type & = allocator_type());
  template<typename InputIterator> 
    flat_multimap(InputIterator, InputIterator, const allocator_type &);
  template<typename InputIterator> 
    flat_multimap(ordered_range_t, InputIterator, InputIterator, 
                  const Compare & = Compare(), 
                  const allocator_type & = allocator_type());
  flat_multimap(std::initializer_list< value_type >, 
                const Compare & = Compare(), 
                const allocator_type & = allocator_type());
  flat_multimap(std::initializer_list< value_type >, const allocator_type &);
  flat_multimap(ordered_range_t, std::initializer_list< value_type >, 
                const Compare & = Compare(), 
                const allocator_type & = allocator_type());
  flat_multimap(const flat_multimap &);
  flat_multimap(flat_multimap &&) noexcept(boost::container::container_detail::is_nothrow_move_constructible< Compare >::value));
  flat_multimap(const flat_multimap &, const allocator_type &);
  flat_multimap(flat_multimap &&, const allocator_type &);
  flat_multimap & operator=(const flat_multimap &);
  flat_multimap & 
  operator=(flat_multimap &&) 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));
  flat_multimap & operator=(std::initializer_list< value_type >);
  // public member functions
  allocator_type get_allocator() const noexcept;
  stored_allocator_type & get_stored_allocator() noexcept;
  const stored_allocator_type & get_stored_allocator() const noexcept;
  iterator begin() noexcept;
  const_iterator begin() const noexcept;
  iterator end() noexcept;
  const_iterator end() const noexcept;
  reverse_iterator rbegin() noexcept;
  const_reverse_iterator rbegin() const noexcept;
  reverse_iterator rend() noexcept;
  const_reverse_iterator rend() const noexcept;
  const_iterator cbegin() const noexcept;
  const_iterator cend() const noexcept;
  const_reverse_iterator crbegin() const noexcept;
  const_reverse_iterator crend() const noexcept;
  bool empty() const noexcept;
  size_type size() const noexcept;
  size_type max_size() const noexcept;
  size_type capacity() const noexcept;
  void reserve(size_type);
  void shrink_to_fit();
  iterator nth(size_type) noexcept;
  const_iterator nth(size_type) const noexcept;
  size_type index_of(iterator) noexcept;
  size_type index_of(const_iterator) const noexcept;
  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(impl_value_type &&);
  iterator insert(const_iterator, const value_type &);
  iterator insert(const_iterator, value_type &&);
  iterator insert(const_iterator, impl_value_type &&);
  template<typename InputIterator> void insert(InputIterator, InputIterator);
  template<typename InputIterator> 
    void insert(ordered_range_t, InputIterator, InputIterator);
  void insert(std::initializer_list< value_type >);
  void insert(ordered_range_t, std::initializer_list< value_type >);
  template<typename C2> void merge(flat_multimap< Key, T, C2, Allocator > &);
  template<typename C2> void merge(flat_multimap< Key, T, C2, Allocator > &&);
  template<typename C2> void merge(flat_map< Key, T, C2, Allocator > &);
  template<typename C2> void merge(flat_map< Key, T, C2, Allocator > &&);
  iterator erase(const_iterator);
  size_type erase(const key_type &);
  iterator erase(const_iterator, const_iterator);
  void swap(flat_multimap &) 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< iterator, iterator > equal_range(const key_type &);
  std::pair< const_iterator, const_iterator > 
  equal_range(const key_type &) const;
  // friend functions
  friend bool operator==(const flat_multimap &, const flat_multimap &);
  friend bool operator!=(const flat_multimap &, const flat_multimap &);
  friend bool operator<(const flat_multimap &, const flat_multimap &);
  friend bool operator>(const flat_multimap &, const flat_multimap &);
  friend bool operator<=(const flat_multimap &, const flat_multimap &);
  friend bool operator>=(const flat_multimap &, const flat_multimap &);
  friend void swap(flat_multimap &, flat_multimap &);
};

Description

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

А.flat_multimapудовлетворяет всем требованиям контейнера, обратимого контейнера и ассоциативного контейнера. Для flat_multimapключевым_типом является Key, а значение_тип - std::pair(в отличие от std:::multimapкакое значение_тип - std::pair<КонстКлюч, T>.

Сравните функцию заказа для ключей (например,std::less).

Аллокатор — это распределитель для распределения значений_типов (например,allocator< std::pair>).

flat_multimapпохож на std::multimap, но реализован как упорядоченный вектор. Это означает, что вставка нового элемента вflat_mapобесценивает предыдущие итераторы и ссылки.

Стирание элемента делает недействительными итераторы и ссылки, указывающие на элементы, которые приходят после (их ключи больше) стертого элемента.

Этот контейнер обеспечивает итераторы случайного доступа.

Template Parameters

```
typenameKey
```
- ключ_тип карты
```
ФамилияТ
```
```
ИмяСравните=std::меньше<Ключ>
```
является функцией заказа для Ключей (например,std::less).
```
typenameAllocator=new_allocator<std::pair<Key,T>>
```
является распределителем для выделенияvalue_type(например,распределитель< std::pair>.

`flat_multimap` public construct/copy/destruct

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

Эффекты: По умолчанию конструирует пустоеflat_map.

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

```
explicitflat_multimap(constCompare&comp,
                      constallocator_type&a=allocator_type());
```
Эффекты: Конструирует пустоеflat_multimapс помощью указанного объекта сравнения и распределителя.
Сложность: Постоянно.
```
explicitflat_multimap(constallocator_type&a);
```
Эффекты: Построение пустогоflat_multimapс использованием указанного распределителя.
Сложность: Постоянно.
```
шаблон<ФамилияInputIterator>flat_multimapИтератор вводапервый,Итератор вводапоследний,констСравните&comp=Сравните,constallocator_type&a=allocator_type];
```
Эффекты: Конструирует пустойflat_multimapс использованием указанного объекта сравнения и распределителя и вставляет элементы из диапазона [первый, последний ]
Сложность: Линейный в N, если диапазон [первый, последний] уже отсортирован с использованием comp и иначе N logN, где N последний — первый.
```
template<typenameInputIterator>
 flat_multimap(InputIteratorfirst,InputIteratorlast,
               constallocator_type&a);
```
Эффекты: Конструирует пустоеflat_multimapс помощью указанного распределителя и вставляет элементы из диапазона [первый, последний]
Сложность: Линейный в N, если диапазон [первый, последний] уже отсортирован с использованием comp и иначе N logN, где N последний — первый.
```
template<typenameInputIterator>
 flat_multimap(ordered_range_t,InputIteratorfirst,InputIteratorlast,
               constCompare&comp=Compare(),
               constallocator_type&a=allocator_type());
```
Эффекты: Конструирует пустоеflat_multimapс использованием указанного объекта сравнения и распределителя и вставляет элементы из упорядоченного диапазона [первый, последний]. Эта функция более эффективна, чем создание нормального диапазона для упорядоченных диапазонов.
Требует: [первый, последний] должен быть упорядочен согласно предикату.
Сложность: Линейный в N.
Примечание: Нестандартное расширение.
```
flat_multimap(std::initializer_list<value_type>il,
             constCompare&comp=Compare(),
             constallocator_type&a=allocator_type());
```
Эффекты: Конструирует пустоеflat_mapс использованием указанного объекта сравнения и распределителя и вставляет элементы из диапазона [il.begin(), il.end()).
Сложность: Линейный в N, если диапазон [il.begin(), il.end()) уже отсортирован с использованием comp и иначе N logN, где N последний - первый.
```
flat_multimap(std::initializer_list<value_type>il,
             constallocator_type&a);
```
Эффекты: Конструирует пустоеflat_mapс использованием указанного распределителя и вставляет элементы из диапазона [il.begin(), il.end()).
Сложность: Линейный в N, если диапазон [il.begin(), il.end()) уже отсортирован с использованием comp и иначе N logN, где N последний - первый.
```
flat_multimap(ordered_range_t,std::initializer_list<value_type>il,
             constCompare&comp=Compare(),
             constallocator_type&a=allocator_type());
```
Эффекты: Конструирует пустоеflat_multimapс использованием указанного объекта сравнения и распределителя и вставляет элементы из упорядоченного диапазона [il.begin(), il.end()). Эта функция более эффективна, чем создание нормального диапазона для упорядоченных диапазонов.
Требует: [il.begin(), il.end()) должен быть упорядочен в соответствии с предикатом.
Сложность: Линейный в N.
Примечание: Нестандартное расширение.
```
flat_multimap(constflat_multimap&x);
```
Эффекты: Копия конструирует aflat_multimap.
Сложность: Линейный в x.size().
```
flat_multimapflat_multimap&&xне исключениебустер::контейнер::контейнер_деталь::]
```
Эффекты[128flat_multimap. Конструирует это с использованием ресурсов x.
Сложность: Константа.
Посткондиционер: x опустошается.
```
flat_multimap(constflat_multimap&x,constallocator_type&a);
```
Эффекты: Копия конструируетflat_multimapс помощью указанного распределителя.
Сложность: Линейный в x.size().
```
flat_multimap(flat_multimap&&x,constallocator_type&a);
```
Эффекты: Перемещение конструируетflat_multimapс помощью указанного распределителя. Построение * этого с использованием ресурсов x.
Сложность: Постоянная, если a == x.get_allocator(), линейная иначе.
```
flat_multimap&operator=(constflat_multimap&x);
```
Эффекты: Это копия x.
Сложность: Линейный в x.size().

flat_multimap&
operator=(flat_multimap&&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));

Эффекты:

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

```
flat_multimap&operator=(std::initializer_list<value_type>il);
```
Эффекты: Назначьте содержание il на это
Сложность: Линейный в il.size().

`flat_multimap` public member functions

```
allocator_typeget_allocator()constnoexcept;
```
Эффекты: Возвращает копию распределителя, которая была передана конструктору объекта.
Сложность: Постоянная.
```
stored_allocator_type&get_stored_allocator()noexcept;
```
Эффекты: Возвращает ссылку на внутренний распределитель.
Бросает: Ничто
Сложность: Константа.
Примечание: Нестандартное расширение.
```
conststored_allocator_type&get_stored_allocator()constnoexcept;
```
Эффекты: Возвращает ссылку на внутренний распределитель.
Бросает: Ничто
Сложность: Константа.
Примечание: Нестандартное расширение.
```
итераторначинаютбез исключения;
```
Эффекты: возвращает итератор к первому элементу, содержащемуся в контейнере.
Бросок: Ничего.
Сложность: Постоянная.
```
const_iteratorbegin()constnoexcept;
```
Эффекты: Возвращает const_iterator к первому элементу, содержащемуся в контейнере.
Бросает: Ничего.
Сложность: Постоянная.
```
iteratorend()noexcept;
```
Эффекты: Возвращает итератор в конец контейнера.
Бросает: Ничего.
Сложность: Постоянная.
```
const_iteratorend()constnoexcept;
```
Эффекты: Возвращает const_iterator в конец контейнера.
Бросок: Ничего.
Сложность: Постоянная.
```
reverse_iteratorrbegin()noexcept;
```
Эффекты: Возвращает обратный_iterator, указывающий на начало обратного контейнера.
Бросает: Ничего.
Сложность: Постоянная.
```
const_reverse_iteratorrbegin()constnoexcept;
```
Эффекты: Возвращает const_reverse_iterator, указывающий на начало обратного контейнера.
Бросок: Ничего.
Сложность: Постоянная.
```
reverse_iteratorrend()noexcept;
```
Эффекты: Возвращает обратный_iterator, указывающий на конец обратного контейнера.
Бросок: Ничего.
Сложность: Постоянная.
```
const_reverse_iteratorrend()constnoexcept;
```
Эффекты: Возвращает const_reverse_iterator, указывающий на конец обратного контейнера.
Бросок: Ничего.
Сложность: Постоянная.
```
const_iteratorcbegin()constnoexcept;
```
Эффекты: Возвращает const_iterator к первому элементу, содержащемуся в контейнере.
Бросает: Ничего.
Сложность: Постоянная.
```
const_iteratorcendconstno except;
```
: Возвращает const_iterator в конец контейнера.
Бросок: Ничего.
Сложность: Постоянно.
```
const_reverse_iteratorcrbegin()constnoexcept;
```
Эффекты: Возвращает const_reverse_iterator, указывающий на начало обратного контейнера.
Бросает: Ничего.
Сложность: Постоянная.
```
const_reverse_iteratorcrend()constnoexcept;
```
Эффекты: Возвращает const_reverse_iterator, указывающий на конец обратного контейнера.
Бросок: Ничего.
Сложность: Постоянно.
```
boolempty()constnoexcept;
```
Эффекты: Возвращается, если контейнер не содержит элементов.
Бросок: Ничего.
Сложность: Постоянная.
```
size_typesize()constnoexcept;
```
Эффекты: Возвращает количество элементов, содержащихся в контейнере.
Бросок: Ничего.
Сложность: Постоянная.
```
size_typemax_size()constnoexcept;
```
Эффекты: Возвращает максимально возможный размер контейнера.
Бросает: Ничего.
Сложность: Постоянная.
```
size_typecapacity()constnoexcept;
```
Эффекты: Количество элементов, для которых выделена память. Вместимость () всегда больше или равна размеру ().
Бросает: Ничего.
Сложность: Постоянная.
```
voidreserve(size_typecnt);
```
Эффекты: Если n меньше или равно емкости(), этот вызов не имеет эффекта. В противном случае это запрос на выделение дополнительной памяти. Если запрос является успешным, то емкость () больше или равна n; в противном случае емкость () не изменяется. В любом случае размер() не изменяется.
Бросок: Если выделение памяти бросает, или конструктор копий Т бросает.
Примечание: Если емкость () меньше "cnt", итераторы и ссылки на значения могут быть признаны недействительными.
```
voidshrink_to_fit();
```
Эффекты: Пытается разобраться с избытком созданной памяти
Бросок: Если отбрасывает выделение памяти, или отбрасывает конструктор копий Т.
Сложность: Линейный размер().
```
iteratornth(size_typen)noexcept;
```
Требуется: размер() >= n.
Эффекты: Возвращает итератор к n-му элементу от начала контейнера. Возвращает конец(), если n == размер().
Бросок: Ничего.
Сложность: Постоянная.
Примечание: Нестандартное расширение
```
const_iteratornth(size_typen)constnoexcept;
```
Требуется: размер() >= n.
Эффекты: Возвращает const_iterator к n-му элементу с начала контейнера. Возвращает конец(), если n == размер().
Бросок: Ничего.
Сложность: Постоянная.
Примечание: Нестандартное расширение
```
size_typeindex_of(iteratorp)noexcept;
```
Требуется: start()<= p<= end().
Эффекты: Возвращает индекс элемента, указанный p и размером(), если p == конец().
Бросок: Ничего.
Сложность: Константа.
Примечание: Нестандартное расширение
```
size_typeindex_of(const_iteratorp)constnoexcept;
```
Требуется: start()<= p<= end().
Эффекты: Возвращает индекс элемента, указываемого p и размером(), если p == конец().
Бросает: Ничего.
Сложность: Константа.
Примечание: Нестандартное расширение
```
template<class...Args>iteratoremplace(Args&&...args);
```
Эффекты: Вставляет объект типа T, построенный с помощью std::forward(args)... и возвращает итератор, указывающий на вновь вставленный элемент.
Сложность: Логарифмическое время поиска плюс линейная вставка в элементы с большими клавишами, чем x.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
template<class...Args>
 iteratoremplace_hint(const_iteratorhint,Args&&...args);
```
Эффекты: Вставляет объект типа Т, построенный с помощью std::forward(args)... в контейнер. p - подсказка, указывающая, где вставка должна начать поиск.
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным ключу x.
Сложность: Логарифмическое время поиска (постоянное время, если значение должно быть вставлено перед p) плюс линейная вставка к элементам с большими клавишами, чем x.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
iteratorinsert(constvalue_type&x);
```
Эффекты: Вставляет x и возвращает итератор, указывающий на вновь вставленный элемент.
Сложность: Логарифмическое время поиска плюс линейная вставка в элементы с большими клавишами, чем x.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
iteratorinsert(value_type&&x);
```
Эффекты: Вставляет новое значение, построенное из x, и возвращает итератор, указывающий на вновь вставленный элемент.
Сложность: Логарифмическое время поиска плюс линейная вставка в элементы с большими клавишами, чем x.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
итераторвставитьimpl_value_type&&x;
```
Эффекты: Вставляет новое значение, построенное из x, и возвращает итератор, указывающий на вновь вставленный элемент.
Сложность: Логарифмическое время поиска плюс линейная вставка в элементы с большими клавишами, чем x.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
iteratorinsert(const_iteratorp,constvalue_type&x);
```
Эффекты: Вставьте копию x в контейнер. p - подсказка, указывающая, где вставка должна начать поиск.
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным ключу x.
Сложность: Логарифмическое время поиска (постоянное время, если значение должно быть вставлено перед p) плюс линейная вставка к элементам с большими клавишами, чем x.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
iteratorinsert(const_iteratorp,value_type&&x);
```
Эффекты: Вставляет движение значения, построенное из x в контейнере. p - подсказка, указывающая, где вставка должна начать поиск.
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным ключу x.
Сложность: Логарифмическое время поиска (постоянное время, если значение должно быть вставлено перед p) плюс линейная вставка к элементам с большими клавишами, чем x.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
итераторвставитьconst_iteratorp,impl_value_type&&x;
```
Эффекты: Вставляет движение значения, построенное из x в контейнере. p - подсказка, указывающая, где вставка должна начать поиск.
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным ключу x.
Сложность: Логарифмическое время поиска (постоянное время, если значение должно быть вставлено перед p) плюс линейная вставка к элементам с большими клавишами, чем x.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
template<typenameInputIterator>
 voidinsert(InputIteratorfirst,InputIteratorlast);
```
Требует: во-первых, последние не являются итераторами в *это.
Эффекты: вставляет каждый элемент из диапазона [первый, последний]
Сложность: Максимальное время поиска N log(size()+N) (N - расстояние от первого до последнего) плюс время вставки N*size().
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
template<typenameInputIterator>
 voidinsert(ordered_range_t,InputIteratorfirst,InputIteratorlast);
```
Требует: первый, последний не являются итераторами в *это.
Требует: [первый, последний] должен быть упорядочен в соответствии с предикатом.
Эффекты: вставляет каждый элемент из диапазона [первый, последний], если и только если нет элемента с ключом, эквивалентным ключу этого элемента. Эта функция более эффективна, чем создание нормального диапазона для упорядоченных диапазонов.
Сложность: Максимально N log(size()+N) (N - расстояние от первого до последнего) время поиска плюс N*size() время вставки.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
Примечание: Нестандартное расширение.
```
voidinsert(std::initializer_list<value_type>il);
```
Эффекты: вставляет каждый элемент из диапазона [il.begin(), il.end()) .
Сложность: Максимально N log(size()+N) (N - расстояние от первого до последнего) время поиска плюс N*size() время вставки.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
```
voidinsert(ordered_range_t,std::initializer_list<value_type>il);
```
Требует: [il.begin(), il.end()) должен быть упорядочен в соответствии с предикатом.
Эффекты: вставляет каждый элемент из диапазона [il.begin(), il.end()) если и только если нет элемента с ключом, эквивалентным ключу этого элемента. Эта функция более эффективна, чем создание нормального диапазона для упорядоченных диапазонов.
Сложность: Максимально N log(size()+N) (N - расстояние от первого до последнего) время поиска плюс N*size() время вставки.
Примечание: Если элемент вставлен, это может сделать элементы недействительными.
Примечание: Нестандартное расширение.
```
template<typenameC2>
 voidmerge(flat_multimap<Key,T,C2,Allocator>&source);
```
Требуется: это->get_allocator() == source.get_allocator().
Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *это.
Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в это, а не в источник.
Бросок: Ничего, если объект сравнения не бросает.
Сложность: N log(a.size() + N) (N имеет значение source.size())
```
template<typenameC2>
 voidmerge(flat_multimap<Key,T,C2,Allocator>&&source);
```
Требуется: это->get_allocator() == source.get_allocator().
Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *это.
Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в это, а не в источник.
Бросок: Ничего, если объект сравнения не бросит.
Сложность: N log(a.size() + N) (N имеет значение source.size())
```
template<typenameC2>voidmerge(flat_map<Key,T,C2,Allocator>&source);
```
Требуется: это->get_allocator() == source.get_allocator().
Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *это.
Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в это, а не в источник.
Бросок: Ничего, если объект сравнения не бросает.
Сложность: N log(a.size() + N) (N имеет значение source.size())
```
template<typenameC2>voidmerge(flat_map<Key,T,C2,Allocator>&&source);
```
Требуется:
Эффекты: Извлекает каждый элемент в источнике и вставляет его в объект сравнения *это.
Посткондиция: Указатели и ссылки на переданные элементы источника относятся к тем же элементам, но как к членам этого. Итераторы, относящиеся к переданным элементам, будут продолжать ссылаться на их элементы, но теперь они ведут себя как итераторы в это, а не в источник.
Бросок: Ничего, если объект сравнения не бросит.
Сложность: N log(a.size() + N) (N имеет значение source.size())
```
iteratorerase(const_iteratorp);
```
Эффекты: Стирает элемент, на который указывает p.
Возвращает: Возвращает итератор, указывающий на элемент непосредственно после q перед стиранием элемента. Если такого элемента не существует, возвращается конец ().
Сложность: Линейные к элементам с ключами больше, чем p
Примечание: Инвалидирует элементы ключами не меньше, чем стертый элемент.
```
size_typeerase(constkey_type&x);
```
Эффекты: Стирает все элементы в контейнере с ключом, эквивалентным x.
Возвращает: Возвращает число стертых элементов.
Сложность: Логарифмическое время поиска плюс время стирания линейно элементам с большими клавишами.
```
iteratorerase(const_iteratorfirst,const_iteratorlast);
```
Эффекты: Стирает все элементы в диапазоне [первый, последний].
Возвращение: Возвращается последним.
Сложность: размер()*N, где N — расстояние от первого до последнего.
Сложность: Логарифмическое время поиска плюс время стирания линейно элементам с большими клавишами.

voidswap(flat_multimap&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, построенный из объекта сравнения.
Сложность: Постоянная.
```
iteratorfind(constkey_type&x);
```
Возвращение: Итератор, указывающий на элемент с ключом, эквивалентным x, или конец(), если такой элемент не найден.
Сложность: Логарифмический.
```
const_iteratorfindconstkey_type&x]const;
```
Returns: Const_iterator, указывающий на элемент с ключом, эквивалентным x, или конец(), если такой элемент не найден.
Сложность: Логарифмический.
```
size_typecount(constkey_type&x)const;
```
Возвращение: Число элементов с ключом, эквивалентным x.
Сложность: log(size())+count(k)
```
iteratorlower_bound(constkey_type&x);
```
Возвращение: Итератор, указывающий на первый элемент ключом не менее k, или a.end(), если такой элемент не найден.
Сложность: Логарифмический
```
const_iteratorlower_boundconstkey_type&x]const;
```
Возвращение: Конст-итератор, указывающий на первый элемент с ключом не менее k, или a.end(), если такой элемент не найден.
Сложность: Логарифмический
```
iteratorupper_bound(constkey_type&x);
```
Возвращение: Итератор, указывающий на первый элемент с ключом не менее x, или конец(), если такой элемент не найден.
Сложность: Логарифмический
```
const_iteratorupper_boundconstkey_type&x]const;
```
Возвращение: Конст-итератор, указывающий на первый элемент с ключом не менее x, или конец(), если такой элемент не найден.
Сложность: Логарифмический
```
std::pair<iterator,iterator>equal_range(constkey_type&x);
```
Эффекты: Эквивалент std::make_pair(this->lower_bound(k), this->upper_bound(k)).
Сложность: Логарифмический
```
std::pair<const_iterator,const_iterator>equal_rangeconst&const;
```
Эффекты: Эквивалент std::make_pair(this->lower_bound(k), this->upper_bound(k)).
Сложность: Логарифмический

`flat_multimap` friend functions

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

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

Class template flat_multimap

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

Boost C++ Libraries

Class template flat_multimap

Synopsis

Description

Template Parameters

flat_multimap public construct/copy/destruct

flat_multimap public member functions

flat_multimap friend functions

`flat_multimap` public construct/copy/destruct

`flat_multimap` public member functions

`flat_multimap` friend functions