1#ifndef NEFORCE_CORE_CONTAINER_UNORDERED_MAP_HPP__
2#define NEFORCE_CORE_CONTAINER_UNORDERED_MAP_HPP__
15NEFORCE_BEGIN_NAMESPACE__
36template <
typename Key,
typename T,
typename HashFcn = hash<Key>,
typename EqualKey = equal_to<Key>,
37 typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>
42 "allocator type mismatch.");
43 static_assert(
is_object_v<Key>,
"unordered map only contains object types.");
121 ht_(_NEFORCE
move(other.ht_)) {}
129 ht_ = _NEFORCE
move(other.ht_);
139 template <
typename Iterator>
142 ht_.insert_unique(first, last);
152 template <
typename Iterator>
155 ht_.insert_unique(first,
list);
166 template <
typename Iterator>
169 ht_.insert_unique(first, last);
181 template <
typename Iterator>
184 ht_.insert_unique(first, last);
273 NEFORCE_NODISCARD
bool empty() const noexcept {
return ht_.empty(); }
281 return ht_.count(key);
308 return ht_.hash_function();
321 NEFORCE_NODISCARD
float load_factor() const noexcept {
return ht_.load_factor(); }
327 NEFORCE_NODISCARD
float max_load_factor() const noexcept {
return ht_.max_load_factor(); }
355 template <
typename... Args>
380 template <
typename Iterator>
381 void insert(Iterator first, Iterator last) {
382 ht_.insert_unique(first, last);
425 void clear() noexcept { ht_.clear(); }
454 return ht_.equal_range(key);
465 auto iter = ht_.find(key);
466 if (iter == ht_.end()) {
467 iter = ht_.emplace_unique(key, T()).first;
479 auto iter = ht_.find(key);
481 NEFORCE_THROW_EXCEPTION(
iterator_exception(
"unordered_map key-value does not exists"));
493 auto iter = ht_.find(key);
495 NEFORCE_THROW_EXCEPTION(
iterator_exception(
"unordered_map key-value does not exists"));
512 return ht_ == rhs.ht_;
521 return ht_ < rhs.ht_;
525#ifdef NEFORCE_STANDARD_17
526template <
typename Iterator,
typename HashFcn = hash<iter_map_key_t<Iterator>>,
527 typename Compare = equal_to<iter_map_key_t<Iterator>>,
typename Alloc>
528unordered_map(Iterator, Iterator, HashFcn = HashFcn(), Compare = Compare(), Alloc = Alloc())
529 -> unordered_map<iter_map_key_t<Iterator>, iter_map_value_t<Iterator>, HashFcn, Compare, Alloc>;
531template <
typename Key,
typename T,
typename HashFcn = hash<Key>,
typename Compare = equal_to<Key>,
532 typename Alloc = allocator<pair<const Key, T>>>
533unordered_map(std::initializer_list<pair<Key, T>>, HashFcn = HashFcn(), Compare = Compare(), Alloc = Alloc())
534 -> unordered_map<Key, T, HashFcn, Compare, Alloc>;
536template <
typename Iterator,
typename Alloc>
537unordered_map(Iterator, Iterator, Alloc)
538 -> unordered_map<iter_map_key_t<Iterator>, iter_map_value_t<Iterator>, hash<iter_map_key_t<Iterator>>,
539 equal_to<iter_map_key_t<Iterator>>, Alloc>;
541template <
typename Iterator,
typename HashFcn,
typename Alloc>
542unordered_map(Iterator, Iterator, HashFcn, Alloc) -> unordered_map<iter_map_key_t<Iterator>, iter_map_value_t<Iterator>,
543 HashFcn, equal_to<iter_map_key_t<Iterator>>, Alloc>;
545template <
typename Key,
typename T,
typename Alloc>
546unordered_map(std::initializer_list<pair<Key, T>>, Alloc) -> unordered_map<Key, T, hash<Key>, equal_to<Key>, Alloc>;
548template <
typename Key,
typename T,
typename HashFcn,
typename Alloc>
549unordered_map(std::initializer_list<pair<Key, T>>, HashFcn, Alloc)
550 -> unordered_map<Key, T, HashFcn, equal_to<Key>, Alloc>;
555NEFORCE_END_NAMESPACE__
pair< const Key, T > * pointer
pair< const Key, T > value_type
const pair< const Key, T > & const_reference
pair< const Key, T > & reference
ptrdiff_t difference_type
hashtable_iterator< true, hashtable > const_iterator
const pair< const Key, T > * const_pointer
hashtable_iterator< false, hashtable > iterator
typename base_type::const_pointer const_pointer
常量指针类型
unordered_map & operator=(unordered_map &&other) noexcept(is_nothrow_move_assignable_v< base_type >)
移动赋值运算符
pair< iterator, iterator > equal_range(const key_type &key)
获取等于指定键的元素范围
typename base_type::pointer pointer
指针类型
size_type buckets_size() const noexcept
获取桶数量
unordered_map(Iterator first, Iterator list, size_type n)
范围构造函数,指定初始桶数
unordered_map & operator=(const unordered_map &other)
拷贝赋值运算符
bool less_than(const unordered_map &rhs) const noexcept(noexcept(ht_< rhs.ht_))
小于比较操作符
unordered_map(std::initializer_list< value_type > ilist, size_type n)
初始化列表构造函数,指定初始桶数
unordered_map(Iterator first, Iterator last, size_type n, const hasher &hf, const key_equal &eql)
范围构造函数,指定初始桶数、哈希函数和键相等比较函数
unordered_map(unordered_map &&other) noexcept(is_nothrow_move_constructible_v< base_type >)
移动构造函数
size_type bucket_size(size_type n) const noexcept
获取指定桶的大小
void clear() noexcept
清空unordered_map
typename base_type::const_iterator const_iterator
常量迭代器类型
void rehash(size_type n)
重新哈希,调整桶数量
iterator find(const key_type &key)
查找具有指定键的元素
const_iterator cbegin() const noexcept
获取常量起始迭代器
void reserve(size_type n)
预留空间
unordered_map(size_type n)
构造函数,指定初始桶数
const_iterator erase(const_iterator first, const_iterator last) noexcept
删除指定范围内的常量元素
pair< iterator, bool > insert(value_type &&value)
移动插入元素
void swap(unordered_map &other) noexcept(is_nothrow_swappable_v< base_type >)
交换两个unordered_map的内容
hasher hash_function() const noexcept(noexcept(ht_.hash_function()))
获取哈希函数对象
T & operator[](const key_type &key)
下标访问操作符
const_iterator begin() const noexcept
获取常量起始迭代器
size_type buckets_max_count() const noexcept
获取最大桶数量
float max_load_factor() const noexcept
获取最大负载因子
const_iterator cend() const noexcept
获取常量结束迭代器
typename base_type::iterator iterator
迭代器类型
typename base_type::key_type key_type
键类型
pair< const_iterator, const_iterator > equal_range(const key_type &key) const
获取等于指定键的常量元素范围
unordered_map(size_type n, const hasher &hf, const key_equal &eql)
构造函数,指定初始桶数、哈希函数和键相等比较函数
void insert(Iterator first, Iterator last)
范围插入元素
unordered_map(std::initializer_list< value_type > ilist, size_type n, const hasher &hf)
初始化列表构造函数,指定初始桶数和哈希函数
unordered_map(const unordered_map &other)
拷贝构造函数
bool empty() const noexcept
检查是否为空
typename base_type::hasher hasher
哈希函数类型
const_iterator find(const key_type &key) const
查找具有指定键的常量元素
typename base_type::size_type size_type
大小类型
size_type erase(const key_type &key) noexcept
删除所有具有指定键的元素
typename base_type::difference_type difference_type
差值类型
float load_factor() const noexcept
获取当前负载因子
unordered_map(Iterator first, Iterator last)
范围构造函数
iterator erase(iterator position) noexcept
删除指定位置的元素
unordered_map(std::initializer_list< value_type > ilist)
初始化列表构造函数
typename base_type::reference reference
引用类型
unordered_map(Iterator first, Iterator last, size_type n, const hasher &hf)
范围构造函数,指定初始桶数和哈希函数
const_iterator erase(const_iterator position) noexcept
删除指定位置的常量元素
const_iterator end() const noexcept
获取常量结束迭代器
iterator begin() noexcept
typename base_type::value_type value_type
值类型
pair< iterator, bool > emplace(Args &&... args)
在unordered_map中就地构造元素
bool equal_to(const unordered_map &rhs) const noexcept(noexcept(ht_==rhs.ht_))
相等比较操作符
T & at(const key_type &key)
带边界检查的访问
unordered_map()=default
默认构造函数
const T & at(const key_type &key) const
带边界检查的常量访问
size_type max_size() const noexcept
获取最大可能大小
unordered_map(size_type n, const hasher &hf)
构造函数,指定初始桶数和哈希函数
unordered_map(std::initializer_list< value_type > ilist, size_type n, const hasher &hf, const key_equal &eql)
初始化列表构造函数,指定初始桶数、哈希函数和键相等比较函数
typename base_type::key_equal key_equal
键相等比较函数类型
typename base_type::allocator_type allocator_type
分配器类型
void max_load_factor(float lf) noexcept
设置最大负载因子
pair< iterator, bool > insert(const value_type &value)
插入元素(拷贝版本)
key_equal key_eql() const noexcept(noexcept(ht_.key_eql()))
获取键相等比较函数对象
size_type size() const noexcept
获取元素数量
iterator erase(iterator first, iterator last) noexcept
删除指定范围内的元素
typename base_type::const_reference const_reference
常量引用类型
size_type count(const key_type &key) const noexcept(noexcept(ht_.count(key)))
统计具有指定键的元素数量
constexpr T && forward(remove_reference_t< T > &x) noexcept
完美转发左值
constexpr bool is_object_v
is_object的便捷变量模板
constexpr bool is_hash_v
is_hash的便捷变量模板
constexpr Iterator2 move(Iterator1 first, Iterator1 last, Iterator2 result) noexcept(noexcept(inner::__move_aux(first, last, result)))
移动范围元素
constexpr bool is_nothrow_swappable_v
is_nothrow_swappable的便捷变量模板
constexpr bool is_allocator_v
is_allocator的便捷变量模板
constexpr bool is_nothrow_move_assignable_v
is_nothrow_move_assignable的便捷变量模板
constexpr bool is_nothrow_move_constructible_v
is_nothrow_move_constructible的便捷变量模板
constexpr bool is_same_v
is_same的便捷变量模板