NexusForce 1.0.0
A Modern C++ Library with extended functionality, web components, and utility libraries
载入中...
搜索中...
未找到
variant.hpp
浏览该文件的文档.
1#ifndef NEFORCE_CORE_UTILITY_VARIANT_HPP__
2#define NEFORCE_CORE_UTILITY_VARIANT_HPP__
3
11
16NEFORCE_BEGIN_NAMESPACE__
17
23
30template <typename Variant, typename T>
32
33#ifdef NEFORCE_STANDARD_14
38template <typename Variant, typename T>
39NEFORCE_INLINE17 constexpr size_t variant_index_v = variant_index<Variant, T>::value;
40#endif
41
48template <typename Variant, size_t Idx>
50
55template <typename Variant, size_t Idx>
57
58
67template <typename... Types>
68struct variant : icommon<variant<Types...>> {
69 static_assert(sizeof...(Types) > 0, "variant must have at least one type");
70
71 static_assert(!is_any_of<none_t, Types...>::value ||
72 (is_any_of<none_t, Types...>::value && is_same<get_first_para_t<Types...>, none_t>::value),
73 "if variant holds none, it should be in the first place");
74
75private:
76 size_t index_ = 0;
77
85 alignas(_NEFORCE max({alignof(Types)...})) byte_t union_[_NEFORCE max({sizeof(Types)...})]{};
86
87 using destruct_function = void (*)(byte_t*);
88
95 static destruct_function* destructors_table() noexcept {
96 static destruct_function function_ptrs[sizeof...(Types)] = {
97 [](byte_t* union_p) noexcept { reinterpret_cast<Types*>(union_p)->~Types(); }...};
98 return function_ptrs;
99 }
100
101 using copy_construct_function = void (*)(byte_t*, byte_t const*);
102
109 static copy_construct_function* copy_constructors_table() noexcept {
110 static copy_construct_function function_ptrs[sizeof...(Types)] = {
111 [](byte_t* union_dst, byte_t const* union_src) noexcept {
112 new (union_dst) Types(*reinterpret_cast<Types const*>(union_src));
113 }...};
114 return function_ptrs;
115 }
116
117 using copy_assignment_function = void (*)(byte_t*, byte_t const*);
118
125 static copy_assignment_function* copy_assigment_functions_table() noexcept {
126 static copy_assignment_function function_ptrs[sizeof...(Types)] = {
127 [](byte_t* union_dst, byte_t const* union_src) noexcept {
128 *reinterpret_cast<Types*>(union_dst) = *reinterpret_cast<Types const*>(union_src);
129 }...};
130 return function_ptrs;
131 }
132
133 using move_construct_function = void (*)(byte_t*, const byte_t*);
134
141 static move_construct_function* move_constructors_table() noexcept {
142 static move_construct_function function_ptrs[sizeof...(Types)] = {
143 [](byte_t* union_dst, const byte_t* union_src) noexcept {
144 new (union_dst) Types(_NEFORCE move(*reinterpret_cast<const Types*>(union_src)));
145 }...};
146 return function_ptrs;
147 }
148
149 using move_assignment_function = void (*)(byte_t*, byte_t*);
150
157 static move_assignment_function* move_assigment_functions_table() noexcept {
158 static move_assignment_function function_ptrs[sizeof...(Types)] = {
159 [](byte_t* union_dst, byte_t* union_src) noexcept {
160 *reinterpret_cast<Types*>(union_dst) = _NEFORCE move(*reinterpret_cast<Types*>(union_src));
161 }...};
162 return function_ptrs;
163 }
164
165 template <typename Lambda>
166 using const_visitor_function = common_type_t<_NEFORCE invoke_result_t<Lambda, Types const&>...> (*)(
167 byte_t const*, Lambda&&);
168
176 template <typename Lambda>
177 static const_visitor_function<Lambda>* const_visitors_table() noexcept {
178 static const_visitor_function<Lambda> function_ptrs[sizeof...(Types)] = {
179 [](byte_t const* union_p, Lambda&& lambda) -> _NEFORCE invoke_result_t<Lambda, Types const&> {
180 return _NEFORCE invoke(_NEFORCE forward<Lambda>(lambda), *reinterpret_cast<Types const*>(union_p));
181 }...};
182 return function_ptrs;
183 }
184
185 template <typename Lambda>
186 using visitor_function =
188
196 template <typename Lambda>
197 static visitor_function<Lambda>* visitors_table() noexcept {
198 static visitor_function<Lambda> function_ptrs[sizeof...(Types)] = {
199 [](byte_t* union_p, Lambda&& lambda) -> common_type_t<_NEFORCE invoke_result_t<Lambda, Types&>...> {
200 return _NEFORCE invoke(_NEFORCE forward<Lambda>(lambda), *reinterpret_cast<Types*>(union_p));
201 }...};
202 return function_ptrs;
203 }
204
205 template <size_t I, typename... Args,
207 constexpr bool try_construct_impl_aux_aux(Args&&... args) {
208 index_ = I;
209 new (union_) variant_alternative_t<variant, I>(_NEFORCE forward<Args>(args)...);
210 return true;
211 }
212
213 template <size_t I, typename... Args,
215 constexpr bool try_construct_impl_aux_aux(Args&&... args) {
216 return variant::try_construct_impl<I + 1>(_NEFORCE forward<Args>(args)...);
217 }
218
219 template <size_t I, typename... Args, enable_if_t<(I < sizeof...(Types)), int> = 0>
220 constexpr bool try_construct_impl_aux(Args&&... args) {
221 return variant::try_construct_impl_aux_aux<I>(_NEFORCE forward<Args>(args)...);
222 }
223
224 template <size_t I, typename... Args, enable_if_t<(I >= sizeof...(Types)), int> = 0>
225 constexpr bool try_construct_impl_aux(Args&&...) {
226 return false;
227 }
228
229 template <size_t I, typename... Args>
230 constexpr bool try_construct_impl(Args&&... args) {
231 return variant::try_construct_impl_aux<I>(_NEFORCE forward<Args>(args)...);
232 }
233
234 template <size_t I = 0, typename... Args>
235 constexpr bool try_construct(Args&&... args) {
236 return variant::try_construct_impl<I>(_NEFORCE forward<Args>(args)...);
237 }
238
239public:
247 }
248
256 template <typename T, enable_if_t<disjunction_v<is_same<T, Types>...>, int> = 0>
257 NEFORCE_CONSTEXPR20 explicit variant(T&& value) noexcept(is_nothrow_move_constructible_v<T>) :
258 index_(variant_index_v<variant, T>) {
259 T* p = reinterpret_cast<T*>(union_);
260 new (p) T(_NEFORCE forward<T>(value));
261 }
262
269 NEFORCE_CONSTEXPR20 variant(const variant& other) :
270 index_(other.index_) {
271 copy_constructors_table()[index()](union_, other.union_);
272 }
273
281 NEFORCE_CONSTEXPR20 variant& operator=(const variant& other) {
282 if (_NEFORCE addressof(other) == this) {
283 return *this;
284 }
285 index_ = other.index_;
286 copy_assigment_functions_table()[index()](union_, other.union_);
287 return *this;
288 }
289
296 NEFORCE_CONSTEXPR20 variant(variant&& other) noexcept :
297 index_(other.index_) {
298 move_constructors_table()[index()](union_, other.union_);
299 }
300
308 NEFORCE_CONSTEXPR20 variant& operator=(variant&& other) noexcept {
309 if (_NEFORCE addressof(other) == this) {
310 return *this;
311 }
312 index_ = other.index_;
313 move_assigment_functions_table()[index()](union_, other.union_);
314 return *this;
315 }
316
325 template <size_t Idx, typename... Args,
327 NEFORCE_CONSTEXPR20 explicit variant(inplace_construct_tag, Args&&... args) noexcept(
329 index_(Idx) {
330 new (union_) variant_alternative_t<variant, Idx>(_NEFORCE forward<Args>(args)...);
331 }
332
343 template <size_t Idx, typename U, typename... Args,
345 int> = 0>
346 NEFORCE_CONSTEXPR20 explicit variant(
347 inplace_construct_tag, std::initializer_list<U> ilist,
349 std::initializer_list<U>&, Args...>) :
350 index_(Idx) {
351 new (union_) variant_alternative_t<variant, Idx>(ilist, _NEFORCE forward<Args>(args)...);
352 }
353
361 template <typename... Args, enable_if_t<disjunction_v<is_constructible<Types, Args...>...>, int> = 0>
362 variant(Args&&... args) {
363 if (!variant::try_construct(_NEFORCE forward<Args>(args)...)) {
364 index_ = 0;
366 }
367 }
368
374 NEFORCE_CONSTEXPR20 ~variant() noexcept { destructors_table()[index()](union_); }
375
384 template <typename Lambda, enable_if_t<conjunction_v<is_invocable<Lambda, Types&>...>, int> = 0>
387 return visitors_table<Lambda>()[index()](union_, _NEFORCE forward<Lambda>(lambda));
388 }
389
398 template <typename Lambda, enable_if_t<conjunction_v<is_invocable<Lambda, const Types&>...>, int> = 0>
399 NEFORCE_CONSTEXPR20 common_type_t<invoke_result_t<Lambda, const Types&>...> visit(Lambda&& lambda) const
401 return const_visitors_table<Lambda>()[index()](union_, _NEFORCE forward<Lambda>(lambda));
402 }
403
408 NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 size_t index() const noexcept { return index_; }
409
415 template <typename T, enable_if_t<is_any_of_v<T, Types...>, int> = 0>
416 NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 bool holds_alternative() const noexcept {
417 return variant_index_v<variant, T> == index_;
418 }
419
426 template <size_t Idx, enable_if_t<(Idx < sizeof...(Types)), int> = 0>
428 if (index_ != Idx) {
429 NEFORCE_THROW_EXCEPTION(value_exception("Template index not match."));
430 }
431 return *reinterpret_cast<variant_alternative_t<variant, Idx>*>(union_);
432 }
433
440 template <typename T>
441 NEFORCE_CONSTEXPR20 T& get() {
443 }
444
451 template <size_t Idx, enable_if_t<(Idx < sizeof...(Types)), int> = 0>
452 NEFORCE_CONSTEXPR20 variant_alternative_t<variant, Idx> const& get() const {
453 if (index_ != Idx) {
454 NEFORCE_THROW_EXCEPTION(value_exception("Template index not match."));
455 }
456 return *reinterpret_cast<variant_alternative_t<variant, Idx> const*>(union_);
457 }
458
465 template <typename T>
466 NEFORCE_CONSTEXPR20 T const& get() const {
468 }
469
475 template <size_t Idx, enable_if_t<(Idx < sizeof...(Types)), int> = 0>
476 NEFORCE_CONSTEXPR20 variant_alternative_t<variant, Idx>* get_if() noexcept {
477 if (index_ != Idx) {
478 return nullptr;
479 }
480 return reinterpret_cast<variant_alternative_t<variant, Idx>*>(union_);
481 }
482
488 template <typename T>
489 NEFORCE_CONSTEXPR20 T* get_if() noexcept {
491 }
492
498 template <size_t Idx, enable_if_t<(Idx < sizeof...(Types)), int> = 0>
499 NEFORCE_CONSTEXPR20 variant_alternative_t<variant, Idx> const* get_if() const noexcept {
500 if (index_ != Idx) {
501 return nullptr;
502 }
503 return reinterpret_cast<variant_alternative_t<variant, Idx> const*>(union_);
504 }
505
511 template <typename T>
512 NEFORCE_CONSTEXPR20 T const* get_if() const noexcept {
514 }
515
524 template <size_t Idx, typename... Args,
525 enable_if_t<(Idx < sizeof...(Types)) && is_constructible_v<variant_alternative_t<variant, Idx>, Args...>,
526 int> = 0>
527 NEFORCE_CONSTEXPR20 void
529 destructors_table()[index()](union_);
530 index_ = Idx;
531 new (union_) variant_alternative_t<variant, Idx>(_NEFORCE forward<Args>(args)...);
532 }
533
542 template <typename T, typename... Args, enable_if_t<is_constructible_v<T, Args...>, int> = 0>
543 NEFORCE_CONSTEXPR20 void emplace(Args&&... args) noexcept(is_nothrow_constructible_v<T, Args...>) {
545 }
546
553 NEFORCE_CONSTEXPR20 void swap(variant& other) noexcept {
554 if (_NEFORCE addressof(other) == this) {
555 return;
556 }
557
558 size_t this_index = index_;
559 const size_t other_index = other.index_;
560 alignas(_NEFORCE max({alignof(Types)...})) byte_t temp_union[_NEFORCE max({sizeof(Types)...})];
561 move_constructors_table()[this_index](reinterpret_cast<byte_t*>(temp_union), union_);
562 destructors_table()[this_index](union_);
563
564 move_constructors_table()[other_index](union_, other.union_);
565 destructors_table()[other_index](other.union_);
566 move_constructors_table()[this_index](other.union_, reinterpret_cast<byte_t*>(temp_union));
567 destructors_table()[this_index](reinterpret_cast<byte_t*>(temp_union));
568
569 index_ = other_index;
570 other.index_ = this_index;
571 }
572
580 NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 bool operator==(const variant& rhs) const {
581 if (index_ != rhs.index_) {
582 return false;
583 }
584 return this->visit([&](const auto& value) {
585 return rhs.visit([&](const auto& other_value) { return value == other_value; });
586 });
587 }
588
594 NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 bool operator<(const variant& rhs) const {
595 if (index_ != rhs.index_) {
596 return false;
597 }
598 return this->visit([&](const auto& value) {
599 return rhs.visit([&](const auto& other_value) { return value < other_value; });
600 });
601 }
602
607 NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 size_t to_hash() const;
608};
609
610#ifdef NEFORCE_STANDARD_17
611template <typename... Args>
612variant(Args...) -> variant<Args...>;
613#endif
614
616template <typename T, typename... Types>
617struct variant_alternative<variant<T, Types...>, 0> {
618 using type = T;
619};
620template <typename T, typename... Types, size_t Idx>
621struct variant_alternative<variant<T, Types...>, Idx> {
622 using type = typename variant_alternative<variant<Types...>, Idx - 1>::type;
623};
624
625template <typename T, typename... Types>
626struct variant_index<variant<T, Types...>, T> {
627 static constexpr size_t value = 0;
628};
629template <typename T0, typename T, typename... Types>
630struct variant_index<variant<T0, Types...>, T> {
631 static constexpr size_t value = variant_index<variant<Types...>, T>::value + 1;
632};
634
642template <size_t Idx, typename... Types>
643NEFORCE_CONSTEXPR20 variant_alternative_t<variant<Types...>, Idx>& get(variant<Types...>& v) {
644 using T = variant_alternative_t<variant<Types...>, Idx>;
645 using variant_type = variant<Types...>;
646 return static_cast<T&>(static_cast<variant_type&>(v).template get<Idx>());
647}
648
656template <size_t Idx, typename... Types>
657NEFORCE_CONSTEXPR20 const variant_alternative_t<variant<Types...>, Idx>& get(const variant<Types...>& v) {
658 using T = variant_alternative_t<variant<Types...>, Idx>;
659 using variant_type = variant<Types...>;
660 return static_cast<const T&>(static_cast<const variant_type&>(v).template get<Idx>());
661}
662
670template <size_t Idx, typename... Types>
671NEFORCE_CONSTEXPR20 variant_alternative_t<variant<Types...>, Idx>&& get(variant<Types...>&& v) {
672 using T = variant_alternative_t<variant<Types...>, Idx>;
673 using variant_type = variant<Types...>;
674 return static_cast<T&&>(static_cast<variant_type&&>(v).template get<Idx>());
675}
676
684template <size_t Idx, typename... Types>
685NEFORCE_CONSTEXPR20 const variant_alternative_t<variant<Types...>, Idx>&& get(const variant<Types...>&& v) {
686 using T = variant_alternative_t<variant<Types...>, Idx>;
687 using variant_type = variant<Types...>;
688 return static_cast<const T&&>(static_cast<const variant_type&&>(v).template get<Idx>());
689}
690
691
693
694NEFORCE_BEGIN_INNER__
695struct __variant_elem_hasher {
696 template <typename T>
697 constexpr size_t operator()(const T& value) const {
698 return hash<decay_t<T>>{}(value);
699 }
700};
701NEFORCE_END_INNER__
702
703template <typename... Types>
704NEFORCE_CONSTEXPR20 size_t variant<Types...>::to_hash() const {
705 constexpr inner::__variant_elem_hasher hasher{};
706 return variant::visit(hasher);
707}
708
710 // Variant
712
713NEFORCE_END_NAMESPACE__
714#endif // NEFORCE_CORE_UTILITY_VARIANT_HPP__
比较算法
异常处理框架
NEFORCE_NODISCARD constexpr T * addressof(T &x) noexcept
获取对象的地址
NEFORCE_NODISCARD constexpr T && forward(remove_reference_t< T > &x) noexcept
完美转发左值
constexpr const T & max(const T &a, const T &b, Compare comp) noexcept(noexcept(comp(a, b)))
返回两个值中的较大者
unsigned char byte_t
字节类型,定义为无符号字符
NEFORCE_CONSTEXPR14 inner::__invoke_result_aux< Callable, Args... >::type invoke(Callable &&f, Args &&... args) noexcept(is_nothrow_invocable< Callable, Args... >::value)
统一调用接口
typename inner::__invoke_result_aux< F, Args... >::type invoke_result_t
invoke_result的便捷别名
constexpr Iterator2 move(Iterator1 first, Iterator1 last, Iterator2 result) noexcept(noexcept(inner::__move_aux(first, last, result)))
移动范围元素
typename get_first_para< Types... >::type get_first_para_t
get_first_para的便捷别名
typename common_type< Types... >::type common_type_t
common_type的便捷别名
NEFORCE_INLINE17 constexpr bool is_nothrow_default_constructible_v
is_nothrow_default_constructible的便捷变量模板
NEFORCE_INLINE17 constexpr bool is_nothrow_constructible_v
is_nothrow_constructible的便捷变量模板
NEFORCE_INLINE17 constexpr bool is_constructible_v
is_constructible的便捷变量模板
NEFORCE_INLINE17 constexpr bool is_nothrow_move_constructible_v
is_nothrow_move_constructible的便捷变量模板
NEFORCE_INLINE17 constexpr bool disjunction_v
disjunction的便捷变量模板
NEFORCE_INLINE17 constexpr bool is_any_of_v
is_any_of的便捷变量模板
NEFORCE_INLINE17 constexpr bool conjunction_v
conjunction的便捷变量模板
typename enable_if< Test, T >::type enable_if_t
enable_if的便捷别名
NEFORCE_CONSTEXPR20 variant_alternative_t< variant< Types... >, Idx > & get(variant< Types... > &v)
获取变体中指定索引位置的引用
typename variant_alternative< Variant, Idx >::type variant_alternative_t
variant_alternative的便捷别名,获取变体中指定索引位置的类型
NEFORCE_INLINE17 constexpr size_t variant_index_v
variant_index的便捷别名,获取类型在变体中的索引值
统一调用接口
空状态类型
通用接口,同时具备可比较和可哈希功能
原位构造标签
判断类型是否在类型集合中
判断类型是否可以使用指定参数构造
判断两个类型是否相同
空状态类型
变量处理异常
获取变体中指定索引位置的类型
获取类型在变体中的索引
变体类型主模板
variant(Args &&... args)
通用构造函数
NEFORCE_CONSTEXPR20 variant(inplace_construct_tag, Args &&... args) noexcept(is_nothrow_constructible_v< variant_alternative_t< variant, Idx >, Args... >)
参数列表原地构造函数
NEFORCE_CONSTEXPR20 variant & operator=(const variant &other)
拷贝赋值运算符
NEFORCE_CONSTEXPR20 variant_alternative_t< variant, Idx > const * get_if() const noexcept
如果存在,获取指定索引位置的常量指针
NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 size_t index() const noexcept
获取当前存储类型的索引
NEFORCE_CONSTEXPR20 variant(inplace_construct_tag, std::initializer_list< U > ilist, Args &&... args) noexcept(is_nothrow_constructible_v< variant_alternative_t< variant, Idx >, std::initializer_list< U > &, Args... >)
初始化列表原地构造函数
NEFORCE_CONSTEXPR20 variant & operator=(variant &&other) noexcept
移动赋值运算符
NEFORCE_CONSTEXPR20 variant(T &&value) noexcept(is_nothrow_move_constructible_v< T >)
从特定类型值构造
NEFORCE_CONSTEXPR20 variant_alternative_t< variant, Idx > * get_if() noexcept
如果存在,获取指定索引位置的指针
NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 bool operator==(const variant &rhs) const
相等比较运算符
NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 bool holds_alternative() const noexcept
检查是否存储特定类型的值
NEFORCE_CONSTEXPR20 void emplace(Args &&... args) noexcept(is_nothrow_constructible_v< T, Args... >)
构造指定类型的新值
NEFORCE_CONSTEXPR20 variant(variant &&other) noexcept
移动构造函数
NEFORCE_CONSTEXPR20 T const & get() const
获取指定类型值的常量引用
NEFORCE_CONSTEXPR20 void emplace(Args &&... args) noexcept(is_nothrow_constructible_v< variant_alternative_t< variant, Idx >, Args... >)
NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 bool operator<(const variant &rhs) const
小于比较运算符
NEFORCE_NODISCARD NEFORCE_CONSTEXPR20 size_t to_hash() const
计算变体的哈希值
NEFORCE_CONSTEXPR20 common_type_t< invoke_result_t< Lambda, Types & >... > visit(Lambda &&lambda) noexcept(conjunction_v< is_nothrow_invocable< Lambda, Types & >... >)
访问变体值
NEFORCE_CONSTEXPR20 void swap(variant &other) noexcept
交换两个变体的内容
NEFORCE_CONSTEXPR20 variant_alternative_t< variant, Idx > const & get() const
获取指定索引位置的常量引用
NEFORCE_CONSTEXPR20 ~variant() noexcept
析构函数
NEFORCE_CONSTEXPR20 T & get()
获取指定类型值的引用
NEFORCE_CONSTEXPR20 common_type_t< invoke_result_t< Lambda, const Types & >... > visit(Lambda &&lambda) const noexcept(conjunction_v< is_nothrow_invocable< Lambda, const Types & >... >)
常量访问变体值
NEFORCE_CONSTEXPR20 variant() noexcept(is_nothrow_default_constructible_v< variant_alternative_t< variant, 0 > >)
默认构造函数
NEFORCE_CONSTEXPR20 variant(const variant &other)
拷贝构造函数
NEFORCE_CONSTEXPR20 T * get_if() noexcept
如果存在,获取指定类型值的指针
NEFORCE_CONSTEXPR20 T const * get_if() const noexcept
如果存在,获取指定类型值的常量指针
NEFORCE_CONSTEXPR20 variant_alternative_t< variant, Idx > & get()
获取指定索引位置的引用