Coverage Report

Created: 2024-09-23 06:29

/src/abseil-cpp/absl/container/internal/raw_hash_map.h
Line
Count
Source
1
// Copyright 2018 The Abseil Authors.
2
//
3
// Licensed under the Apache License, Version 2.0 (the "License");
4
// you may not use this file except in compliance with the License.
5
// You may obtain a copy of the License at
6
//
7
//      https://www.apache.org/licenses/LICENSE-2.0
8
//
9
// Unless required by applicable law or agreed to in writing, software
10
// distributed under the License is distributed on an "AS IS" BASIS,
11
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
// See the License for the specific language governing permissions and
13
// limitations under the License.
14
15
#ifndef ABSL_CONTAINER_INTERNAL_RAW_HASH_MAP_H_
16
#define ABSL_CONTAINER_INTERNAL_RAW_HASH_MAP_H_
17
18
#include <tuple>
19
#include <type_traits>
20
#include <utility>
21
22
#include "absl/base/attributes.h"
23
#include "absl/base/config.h"
24
#include "absl/base/internal/throw_delegate.h"
25
#include "absl/container/internal/container_memory.h"
26
#include "absl/container/internal/raw_hash_set.h"  // IWYU pragma: export
27
28
namespace absl {
29
ABSL_NAMESPACE_BEGIN
30
namespace container_internal {
31
32
template <class Policy, class Hash, class Eq, class Alloc>
33
class raw_hash_map : public raw_hash_set<Policy, Hash, Eq, Alloc> {
34
  // P is Policy. It's passed as a template argument to support maps that have
35
  // incomplete types as values, as in unordered_map<K, IncompleteType>.
36
  // MappedReference<> may be a non-reference type.
37
  template <class P>
38
  using MappedReference = decltype(P::value(
39
      std::addressof(std::declval<typename raw_hash_map::reference>())));
40
41
  // MappedConstReference<> may be a non-reference type.
42
  template <class P>
43
  using MappedConstReference = decltype(P::value(
44
      std::addressof(std::declval<typename raw_hash_map::const_reference>())));
45
46
  using KeyArgImpl =
47
      KeyArg<IsTransparent<Eq>::value && IsTransparent<Hash>::value>;
48
49
 public:
50
  using key_type = typename Policy::key_type;
51
  using mapped_type = typename Policy::mapped_type;
52
  template <class K>
53
  using key_arg = typename KeyArgImpl::template type<K, key_type>;
54
55
  static_assert(!std::is_reference<key_type>::value, "");
56
57
  // TODO(b/187807849): Evaluate whether to support reference mapped_type and
58
  // remove this assertion if/when it is supported.
59
  static_assert(!std::is_reference<mapped_type>::value, "");
60
61
  using iterator = typename raw_hash_map::raw_hash_set::iterator;
62
  using const_iterator = typename raw_hash_map::raw_hash_set::const_iterator;
63
64
2
  raw_hash_map() {}
65
  using raw_hash_map::raw_hash_set::raw_hash_set;
66
67
  // The last two template parameters ensure that both arguments are rvalues
68
  // (lvalue arguments are handled by the overloads below). This is necessary
69
  // for supporting bitfield arguments.
70
  //
71
  //   union { int n : 1; };
72
  //   flat_hash_map<int, int> m;
73
  //   m.insert_or_assign(n, n);
74
  template <class K = key_type, class V = mapped_type, K* = nullptr,
75
            V* = nullptr>
76
  std::pair<iterator, bool> insert_or_assign(key_arg<K>&& k, V&& v)
77
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
78
    return insert_or_assign_impl(std::forward<K>(k), std::forward<V>(v));
79
  }
80
81
  template <class K = key_type, class V = mapped_type, K* = nullptr>
82
  std::pair<iterator, bool> insert_or_assign(key_arg<K>&& k, const V& v)
83
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
84
    return insert_or_assign_impl(std::forward<K>(k), v);
85
  }
86
87
  template <class K = key_type, class V = mapped_type, V* = nullptr>
88
  std::pair<iterator, bool> insert_or_assign(const key_arg<K>& k, V&& v)
89
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
90
    return insert_or_assign_impl(k, std::forward<V>(v));
91
  }
92
93
  template <class K = key_type, class V = mapped_type>
94
  std::pair<iterator, bool> insert_or_assign(const key_arg<K>& k, const V& v)
95
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
96
    return insert_or_assign_impl(k, v);
97
  }
98
99
  template <class K = key_type, class V = mapped_type, K* = nullptr,
100
            V* = nullptr>
101
  iterator insert_or_assign(const_iterator, key_arg<K>&& k,
102
                            V&& v) ABSL_ATTRIBUTE_LIFETIME_BOUND {
103
    return insert_or_assign(std::forward<K>(k), std::forward<V>(v)).first;
104
  }
105
106
  template <class K = key_type, class V = mapped_type, K* = nullptr>
107
  iterator insert_or_assign(const_iterator, key_arg<K>&& k,
108
                            const V& v) ABSL_ATTRIBUTE_LIFETIME_BOUND {
109
    return insert_or_assign(std::forward<K>(k), v).first;
110
  }
111
112
  template <class K = key_type, class V = mapped_type, V* = nullptr>
113
  iterator insert_or_assign(const_iterator, const key_arg<K>& k,
114
                            V&& v) ABSL_ATTRIBUTE_LIFETIME_BOUND {
115
    return insert_or_assign(k, std::forward<V>(v)).first;
116
  }
117
118
  template <class K = key_type, class V = mapped_type>
119
  iterator insert_or_assign(const_iterator, const key_arg<K>& k,
120
                            const V& v) ABSL_ATTRIBUTE_LIFETIME_BOUND {
121
    return insert_or_assign(k, v).first;
122
  }
123
124
  // All `try_emplace()` overloads make the same guarantees regarding rvalue
125
  // arguments as `std::unordered_map::try_emplace()`, namely that these
126
  // functions will not move from rvalue arguments if insertions do not happen.
127
  template <class K = key_type, class... Args,
128
            typename std::enable_if<
129
                !std::is_convertible<K, const_iterator>::value, int>::type = 0,
130
            K* = nullptr>
131
  std::pair<iterator, bool> try_emplace(key_arg<K>&& k, Args&&... args)
132
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
133
    return try_emplace_impl(std::forward<K>(k), std::forward<Args>(args)...);
134
  }
135
136
  template <class K = key_type, class... Args,
137
            typename std::enable_if<
138
                !std::is_convertible<K, const_iterator>::value, int>::type = 0>
139
  std::pair<iterator, bool> try_emplace(const key_arg<K>& k, Args&&... args)
140
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
141
    return try_emplace_impl(k, std::forward<Args>(args)...);
142
  }
143
144
  template <class K = key_type, class... Args, K* = nullptr>
145
  iterator try_emplace(const_iterator, key_arg<K>&& k,
146
                       Args&&... args) ABSL_ATTRIBUTE_LIFETIME_BOUND {
147
    return try_emplace(std::forward<K>(k), std::forward<Args>(args)...).first;
148
  }
149
150
  template <class K = key_type, class... Args>
151
  iterator try_emplace(const_iterator, const key_arg<K>& k,
152
                       Args&&... args) ABSL_ATTRIBUTE_LIFETIME_BOUND {
153
    return try_emplace(k, std::forward<Args>(args)...).first;
154
  }
155
156
  template <class K = key_type, class P = Policy>
157
  MappedReference<P> at(const key_arg<K>& key) ABSL_ATTRIBUTE_LIFETIME_BOUND {
158
    auto it = this->find(key);
159
    if (it == this->end()) {
160
      base_internal::ThrowStdOutOfRange(
161
          "absl::container_internal::raw_hash_map<>::at");
162
    }
163
    return Policy::value(&*it);
164
  }
165
166
  template <class K = key_type, class P = Policy>
167
  MappedConstReference<P> at(const key_arg<K>& key) const
168
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
169
    auto it = this->find(key);
170
    if (it == this->end()) {
171
      base_internal::ThrowStdOutOfRange(
172
          "absl::container_internal::raw_hash_map<>::at");
173
    }
174
    return Policy::value(&*it);
175
  }
176
177
  template <class K = key_type, class P = Policy, K* = nullptr>
178
  MappedReference<P> operator[](key_arg<K>&& key)
179
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
180
    // It is safe to use unchecked_deref here because try_emplace
181
    // will always return an iterator pointing to a valid item in the table,
182
    // since it inserts if nothing is found for the given key.
183
    return Policy::value(
184
        &this->unchecked_deref(try_emplace(std::forward<K>(key)).first));
185
  }
186
187
  template <class K = key_type, class P = Policy>
188
  MappedReference<P> operator[](const key_arg<K>& key)
189
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
190
    // It is safe to use unchecked_deref here because try_emplace
191
    // will always return an iterator pointing to a valid item in the table,
192
    // since it inserts if nothing is found for the given key.
193
    return Policy::value(&this->unchecked_deref(try_emplace(key).first));
194
  }
195
196
 private:
197
  template <class K, class V>
198
  std::pair<iterator, bool> insert_or_assign_impl(K&& k, V&& v)
199
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
200
    auto res = this->find_or_prepare_insert(k);
201
    if (res.second) {
202
      this->emplace_at(res.first, std::forward<K>(k), std::forward<V>(v));
203
    } else {
204
      Policy::value(&*res.first) = std::forward<V>(v);
205
    }
206
    return res;
207
  }
208
209
  template <class K = key_type, class... Args>
210
  std::pair<iterator, bool> try_emplace_impl(K&& k, Args&&... args)
211
      ABSL_ATTRIBUTE_LIFETIME_BOUND {
212
    auto res = this->find_or_prepare_insert(k);
213
    if (res.second) {
214
      this->emplace_at(res.first, std::piecewise_construct,
215
                       std::forward_as_tuple(std::forward<K>(k)),
216
                       std::forward_as_tuple(std::forward<Args>(args)...));
217
    }
218
    return res;
219
  }
220
};
221
222
}  // namespace container_internal
223
ABSL_NAMESPACE_END
224
}  // namespace absl
225
226
#endif  // ABSL_CONTAINER_INTERNAL_RAW_HASH_MAP_H_