Class vector_multimap

Synopsis

#include <include/EASTL/vector_multimap.h>

template <typename Key, typename T, typename Compare = eastl::less<Key>, 
		  typename Allocator = EASTLAllocatorType,
		  typename RandomAccessContainer = eastl::vector<eastl::pair<Key, T>, Allocator> >
class vector_multimap : public RandomAccessContainer

Description

vector_multimap

Implements a multimap via a random access container such as a vector.

Note that with vector_set, vector_multiset, vector_map, vector_multimap that the modification of the container potentially invalidates all existing iterators into the container, unlike what happens with conventional sets and maps.

Note that the erase functions return iterator and not void. This allows for more efficient use of the container and is consistent with the C++ language defect report #130 (DR 130)

Note that we set the value_type to be pair<Key, T> and not pair<const Key, T>. This means that the underlying container (e.g vector) is a container of pair<Key, T>. Our vector and deque implementations are optimized to assign values in-place and using a vector of pair<const Key, T> (note the const) would make it hard to use our existing vector implementation without a lot of headaches. As a result, at least for the time being we do away with the const. This means that the insertion type varies between map and vector_map in that the latter doesn't take const. This also means that a certain amount of automatic safety provided by the implementation is lost, as the compiler will let the wayward user modify a key and thus make the container no longer ordered behind its back.

Mentioned in

Inheritance

Ancestors: vector

Methods

vector_multimap overloadvector_multimap
count
emplaceInherited from base class:
emplace_back
emplace_back_unsorted
emplace_hint
equal_range overload
equal_range_small overloadequal_range_small This is a special version of equal_range which is optimized for the case of there being few or no duplicated keys in the tree.
equal_range_small overload/ VC++ fails to compile this when defined here, saying the function isn't a member of vector_multimap
erase overload
find overload
find_as overload
insert overload
key_comp overload
lower_bound overload
operator= overload
push_back overloadFunctions which are disallowed due to being unsafe.
push_back_uninitialized
push_back_unsortedNOTE(rparolin): It is undefined behaviour if user code fails to ensure the container invariants are respected by performing an explicit call to 'sort' before any other operations on the container are performed that do not clear the elements.
swap
upper_bound overload
value_comp overload

Source

Lines 120-294 in include/EASTL/vector_multimap.h.

template <typename Key, typename T, typename Compare = eastl::less<Key>, 
          typename Allocator = EASTLAllocatorType,
          typename RandomAccessContainer = eastl::vector<eastl::pair<Key, T>, Allocator> >
class vector_multimap : public RandomAccessContainer
{
public:
    typedef RandomAccessContainer                                              base_type;
    typedef vector_multimap<Key, T, Compare, Allocator, RandomAccessContainer> this_type;
    typedef Allocator                                                          allocator_type;
    typedef Key                                                                key_type;
    typedef T                                                                  mapped_type;
    typedef eastl::pair<Key, T>                                                value_type;
    typedef Compare                                                            key_compare;
    typedef multimap_value_compare<Key, value_type, Compare>                   value_compare;
    typedef value_type*                                                        pointer;
    typedef const value_type*                                                  const_pointer;
    typedef value_type&                                                        reference;
    typedef const value_type&                                                  const_reference;
    typedef typename base_type::size_type                                      size_type;
    typedef typename base_type::difference_type                                difference_type;
    typedef typename base_type::iterator                                       iterator;
    typedef typename base_type::const_iterator                                 const_iterator;
    typedef typename base_type::reverse_iterator                               reverse_iterator;
    typedef typename base_type::const_reverse_iterator                         const_reverse_iterator;
    using base_type::begin;
    using base_type::end;
    using base_type::get_allocator;
protected:
    value_compare mValueCompare;
public:
    // We have an empty ctor and a ctor that takes an allocator instead of one for both
    // because this way our RandomAccessContainer wouldn't be required to have an constructor
    // that takes allocator_type. 
    vector_multimap();
    explicit vector_multimap(const allocator_type& allocator);
    explicit vector_multimap(const key_compare& comp, const allocator_type& allocator = EASTL_VECTOR_MULTIMAP_DEFAULT_ALLOCATOR);
    vector_multimap(const this_type& x);
    vector_multimap(this_type&& x);
    vector_multimap(this_type&& x, const allocator_type& allocator);
    vector_multimap(std::initializer_list<value_type> ilist, const key_compare& compare = key_compare(), const allocator_type& allocator = EASTL_VECTOR_MULTIMAP_DEFAULT_ALLOCATOR);
    template <typename InputIterator>
    vector_multimap(InputIterator first, InputIterator last); // allocator arg removed because VC7.1 fails on the default arg. To do: Make a second version of this function without a default arg.
    template <typename InputIterator>
    vector_multimap(InputIterator first, InputIterator last, const key_compare& compare); // allocator arg removed because VC7.1 fails on the default arg. To do: Make a second version of this function without a default arg.
    this_type& operator=(const this_type& x);
    this_type& operator=(std::initializer_list<value_type> ilist);
    this_type& operator=(this_type&& x);
    void swap(this_type& x);
    const key_compare& key_comp() const;
    key_compare&       key_comp();
    const value_compare& value_comp() const;
    value_compare&       value_comp();
    // Inherited from base class:
    //
    //     allocator_type& get_allocator();
    //     void            set_allocator(const allocator_type& allocator);
    //
    //     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;
    //
    //     size_type size() const;
    //     bool      empty() const;
    //     void      clear();
    template <class... Args>
    iterator emplace(Args&&... args);
    template <class... Args> 
    iterator emplace_hint(const_iterator position, Args&&... args);
    iterator insert(const value_type& value);   // The signature of this function was change in EASTL v2.05.00 from (the mistaken) pair<iterator, bool> to (the correct) iterator.
    template <typename P, typename = eastl::enable_if_t<eastl::is_constructible_v<value_type, P&&>>>
    iterator insert(P&& otherValue);
    iterator insert(const key_type& otherValue);
    iterator insert(key_type&& otherValue);
    iterator insert(const_iterator position, const value_type& value);
    iterator insert(const_iterator position, value_type&& value);
    void insert(std::initializer_list<value_type> ilist);
    template <typename InputIterator>
    void insert(InputIterator first, InputIterator last);
    iterator  erase(const_iterator position);
    iterator  erase(const_iterator first, const_iterator last);
    size_type erase(const key_type& k);
    reverse_iterator erase(const_reverse_iterator position);
    reverse_iterator erase(const_reverse_iterator first, const_reverse_iterator last);
    iterator       find(const key_type& k);
    const_iterator find(const key_type& k) const;
    template <typename U, typename BinaryPredicate>
    iterator       find_as(const U& u, BinaryPredicate predicate);
    template <typename U, typename BinaryPredicate>
    const_iterator find_as(const U& u, BinaryPredicate predicate) const;
    size_type count(const key_type& k) const;
    iterator       lower_bound(const key_type& k);
    const_iterator lower_bound(const key_type& k) const;
    iterator       upper_bound(const key_type& k);
    const_iterator upper_bound(const key_type& k) const;
    eastl::pair<iterator, iterator>             equal_range(const key_type& k);
    eastl::pair<const_iterator, const_iterator> equal_range(const key_type& k) const;
    /// equal_range_small
    /// This is a special version of equal_range which is optimized for the 
    /// case of there being few or no duplicated keys in the tree.
    eastl::pair<iterator, iterator>             equal_range_small(const key_type& k)
    {
        // Defined inline because VC7.1 is broken for when it's defined outside.
        const iterator itLower(lower_bound(k));
        iterator       itUpper(itLower);
        while((itUpper != end()) && !mValueCompare(k, *itUpper))
            ++itUpper;
        return eastl::pair<iterator, iterator>(itLower, itUpper);
    }
    eastl::pair<const_iterator, const_iterator> equal_range_small(const key_type& k) const;
    // Functions which are disallowed due to being unsafe. 
    void      push_back(const value_type& value) = delete;
    reference push_back()                        = delete;
    void*     push_back_uninitialized()          = delete;
    template <class... Args>
    reference emplace_back(Args&&...)            = delete;
    // NOTE(rparolin): It is undefined behaviour if user code fails to ensure the container
    // invariants are respected by performing an explicit call to 'sort' before any other
    // operations on the container are performed that do not clear the elements.
    //
    // 'push_back_unsorted' and 'emplace_back_unsorted' do not satisfy container invariants
    // for being sorted. We provide these overloads explicitly labelled as '_unsorted' as an
    // optimization opportunity when batch inserting elements so users can defer the cost of
    // sorting the container once when all elements are contained. This was done to clarify
    // the intent of code by leaving a trace that a manual call to sort is required.
    // 
    template <typename... Args> decltype(auto) push_back_unsorted(Args&&... args)    
        { return base_type::push_back(eastl::forward<Args>(args)...); }
    template <typename... Args> decltype(auto) emplace_back_unsorted(Args&&... args) 
        { return base_type::emplace_back(eastl::forward<Args>(args)...); }
}; // vector_multimap





Add Discussion as Guest

Log in