utility 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291
  1. // -*- C++ -*-
  2. //===----------------------------------------------------------------------===//
  3. //
  4. // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
  5. // See https://llvm.org/LICENSE.txt for license information.
  6. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
  7. //
  8. //===----------------------------------------------------------------------===//
  9. #ifndef _LIBCPP_UTILITY
  10. #define _LIBCPP_UTILITY
  11. /*
  12. utility synopsis
  13. #include <initializer_list>
  14. namespace std
  15. {
  16. template <class T>
  17. void
  18. swap(T& a, T& b);
  19. namespace rel_ops
  20. {
  21. template<class T> bool operator!=(const T&, const T&);
  22. template<class T> bool operator> (const T&, const T&);
  23. template<class T> bool operator<=(const T&, const T&);
  24. template<class T> bool operator>=(const T&, const T&);
  25. }
  26. template<class T>
  27. void
  28. swap(T& a, T& b) noexcept(is_nothrow_move_constructible<T>::value &&
  29. is_nothrow_move_assignable<T>::value);
  30. template <class T, size_t N>
  31. void
  32. swap(T (&a)[N], T (&b)[N]) noexcept(noexcept(swap(*a, *b)));
  33. template <class T> T&& forward(typename remove_reference<T>::type& t) noexcept; // constexpr in C++14
  34. template <class T> T&& forward(typename remove_reference<T>::type&& t) noexcept; // constexpr in C++14
  35. template <typename T>
  36. [[nodiscard]] constexpr
  37. auto forward_like(auto&& x) noexcept -> see below; // since C++23
  38. template <class T> typename remove_reference<T>::type&& move(T&&) noexcept; // constexpr in C++14
  39. template <class T>
  40. typename conditional
  41. <
  42. !is_nothrow_move_constructible<T>::value && is_copy_constructible<T>::value,
  43. const T&,
  44. T&&
  45. >::type
  46. move_if_noexcept(T& x) noexcept; // constexpr in C++14
  47. template <class T> constexpr add_const_t<T>& as_const(T& t) noexcept; // C++17
  48. template <class T> void as_const(const T&&) = delete; // C++17
  49. template <class T> typename add_rvalue_reference<T>::type declval() noexcept;
  50. template<class T, class U> constexpr bool cmp_equal(T t, U u) noexcept; // C++20
  51. template<class T, class U> constexpr bool cmp_not_equal(T t, U u) noexcept; // C++20
  52. template<class T, class U> constexpr bool cmp_less(T t, U u) noexcept; // C++20
  53. template<class T, class U> constexpr bool cmp_greater(T t, U u) noexcept; // C++20
  54. template<class T, class U> constexpr bool cmp_less_equal(T t, U u) noexcept; // C++20
  55. template<class T, class U> constexpr bool cmp_greater_equal(T t, U u) noexcept; // C++20
  56. template<class R, class T> constexpr bool in_range(T t) noexcept; // C++20
  57. template <class T1, class T2>
  58. struct pair
  59. {
  60. typedef T1 first_type;
  61. typedef T2 second_type;
  62. T1 first;
  63. T2 second;
  64. pair(const pair&) = default;
  65. pair(pair&&) = default;
  66. explicit(see-below) constexpr pair();
  67. explicit(see-below) pair(const T1& x, const T2& y); // constexpr in C++14
  68. template <class U = T1, class V = T2> explicit(see-below) pair(U&&, V&&); // constexpr in C++14
  69. template <class U, class V> constexpr explicit(see-below) pair(pair<U, V>&); // since C++23
  70. template <class U, class V> explicit(see-below) pair(const pair<U, V>& p); // constexpr in C++14
  71. template <class U, class V> explicit(see-below) pair(pair<U, V>&& p); // constexpr in C++14
  72. template <class U, class V>
  73. constexpr explicit(see-below) pair(const pair<U, V>&&); // since C++23
  74. template <pair-like P> constexpr explicit(see-below) pair(P&&); // since C++23
  75. template <class... Args1, class... Args2>
  76. pair(piecewise_construct_t, tuple<Args1...> first_args, // constexpr in C++20
  77. tuple<Args2...> second_args);
  78. constexpr const pair& operator=(const pair& p) const; // since C++23
  79. template <class U, class V> pair& operator=(const pair<U, V>& p); // constexpr in C++20
  80. template <class U, class V>
  81. constexpr const pair& operator=(const pair<U, V>& p) const; // since C++23
  82. pair& operator=(pair&& p) noexcept(is_nothrow_move_assignable<T1>::value &&
  83. is_nothrow_move_assignable<T2>::value); // constexpr in C++20
  84. constexpr const pair& operator=(pair&& p) const; // since C++23
  85. template <class U, class V> pair& operator=(pair<U, V>&& p); // constexpr in C++20
  86. template <class U, class V>
  87. constexpr const pair& operator=(pair<U, V>&& p) const; // since C++23
  88. template <pair-like P> constexpr pair& operator=(P&&); // since C++23
  89. template <pair-like P> constexpr const pair& operator=(P&&) const; // since C++23
  90. void swap(pair& p) noexcept(is_nothrow_swappable_v<T1> &&
  91. is_nothrow_swappable_v<T2>); // constexpr in C++20
  92. constexpr void swap(const pair& p) const noexcept(see below); // since C++23
  93. };
  94. template<class T1, class T2, class U1, class U2, template<class> class TQual, template<class> class UQual>
  95. struct basic_common_reference<pair<T1, T2>, pair<U1, U2>, TQual, UQual>; // since C++23
  96. template<class T1, class T2, class U1, class U2>
  97. struct common_type<pair<T1, T2>, pair<U1, U2>>; // since C++23
  98. template<class T1, class T2> pair(T1, T2) -> pair<T1, T2>;
  99. template <class T1, class T2, class U1, class U2>
  100. bool operator==(const pair<T1,T2>&, const pair<U1,U2>&); // constexpr in C++14
  101. template <class T1, class T2, class U1, class U2>
  102. bool operator!=(const pair<T1,T2>&, const pair<U1,U2>&); // constexpr in C++14, removed in C++20
  103. template <class T1, class T2, class U1, class U2>
  104. bool operator< (const pair<T1,T2>&, const pair<U1,U2>&); // constexpr in C++14, removed in C++20
  105. template <class T1, class T2, class U1, class U2>
  106. bool operator> (const pair<T1,T2>&, const pair<U1,U2>&); // constexpr in C++14, removed in C++20
  107. template <class T1, class T2, class U1, class U2>
  108. bool operator>=(const pair<T1,T2>&, const pair<U1,U2>&); // constexpr in C++14, removed in C++20
  109. template <class T1, class T2, class U1, class U2>
  110. bool operator<=(const pair<T1,T2>&, const pair<U1,U2>&); // constexpr in C++14, removed in C++20
  111. template <class T1, class T2, class U1, class U2>
  112. constexpr common_comparison_type_t<synth-three-way-result<T1,U1>,
  113. synth-three-way-result<T2,U2>>
  114. operator<=>(const pair<T1,T2>&, const pair<U1,U2>&); // C++20
  115. template <class T1, class T2> pair<V1, V2> make_pair(T1&&, T2&&); // constexpr in C++14
  116. template <class T1, class T2>
  117. void
  118. swap(pair<T1, T2>& x, pair<T1, T2>& y) noexcept(noexcept(x.swap(y))); // constexpr in C++20
  119. template<class T1, class T2> // since C++23
  120. constexpr void swap(const pair<T1, T2>& x, const pair<T1, T2>& y) noexcept(noexcept(x.swap(y)));
  121. struct piecewise_construct_t { explicit piecewise_construct_t() = default; };
  122. inline constexpr piecewise_construct_t piecewise_construct = piecewise_construct_t();
  123. template <class T> struct tuple_size;
  124. template <size_t I, class T> struct tuple_element;
  125. template <class T1, class T2> struct tuple_size<pair<T1, T2> >;
  126. template <class T1, class T2> struct tuple_element<0, pair<T1, T2> >;
  127. template <class T1, class T2> struct tuple_element<1, pair<T1, T2> >;
  128. template<size_t I, class T1, class T2>
  129. typename tuple_element<I, pair<T1, T2> >::type&
  130. get(pair<T1, T2>&) noexcept; // constexpr in C++14
  131. template<size_t I, class T1, class T2>
  132. const typename tuple_element<I, pair<T1, T2> >::type&
  133. get(const pair<T1, T2>&) noexcept; // constexpr in C++14
  134. template<size_t I, class T1, class T2>
  135. typename tuple_element<I, pair<T1, T2> >::type&&
  136. get(pair<T1, T2>&&) noexcept; // constexpr in C++14
  137. template<size_t I, class T1, class T2>
  138. const typename tuple_element<I, pair<T1, T2> >::type&&
  139. get(const pair<T1, T2>&&) noexcept; // constexpr in C++14
  140. template<class T1, class T2>
  141. constexpr T1& get(pair<T1, T2>&) noexcept; // C++14
  142. template<class T1, class T2>
  143. constexpr const T1& get(const pair<T1, T2>&) noexcept; // C++14
  144. template<class T1, class T2>
  145. constexpr T1&& get(pair<T1, T2>&&) noexcept; // C++14
  146. template<class T1, class T2>
  147. constexpr const T1&& get(const pair<T1, T2>&&) noexcept; // C++14
  148. template<class T1, class T2>
  149. constexpr T1& get(pair<T2, T1>&) noexcept; // C++14
  150. template<class T1, class T2>
  151. constexpr const T1& get(const pair<T2, T1>&) noexcept; // C++14
  152. template<class T1, class T2>
  153. constexpr T1&& get(pair<T2, T1>&&) noexcept; // C++14
  154. template<class T1, class T2>
  155. constexpr const T1&& get(const pair<T2, T1>&&) noexcept; // C++14
  156. // C++14
  157. template<class T, T... I>
  158. struct integer_sequence
  159. {
  160. typedef T value_type;
  161. static constexpr size_t size() noexcept;
  162. };
  163. template<size_t... I>
  164. using index_sequence = integer_sequence<size_t, I...>;
  165. template<class T, T N>
  166. using make_integer_sequence = integer_sequence<T, 0, 1, ..., N-1>;
  167. template<size_t N>
  168. using make_index_sequence = make_integer_sequence<size_t, N>;
  169. template<class... T>
  170. using index_sequence_for = make_index_sequence<sizeof...(T)>;
  171. template<class T, class U=T>
  172. constexpr T exchange(T& obj, U&& new_value) // constexpr in C++17, noexcept in C++23
  173. noexcept(is_nothrow_move_constructible<T>::value && is_nothrow_assignable<T&, U>::value);
  174. // 20.2.7, in-place construction // C++17
  175. struct in_place_t {
  176. explicit in_place_t() = default;
  177. };
  178. inline constexpr in_place_t in_place{};
  179. template <class T>
  180. struct in_place_type_t {
  181. explicit in_place_type_t() = default;
  182. };
  183. template <class T>
  184. inline constexpr in_place_type_t<T> in_place_type{};
  185. template <size_t I>
  186. struct in_place_index_t {
  187. explicit in_place_index_t() = default;
  188. };
  189. template <size_t I>
  190. inline constexpr in_place_index_t<I> in_place_index{};
  191. // [utility.underlying], to_underlying
  192. template <class T>
  193. constexpr underlying_type_t<T> to_underlying( T value ) noexcept; // C++23
  194. } // std
  195. */
  196. #include <__assert> // all public C++ headers provide the assertion handler
  197. #include <__config>
  198. #include <__utility/as_const.h>
  199. #include <__utility/auto_cast.h>
  200. #include <__utility/cmp.h>
  201. #include <__utility/declval.h>
  202. #include <__utility/exception_guard.h>
  203. #include <__utility/exchange.h>
  204. #include <__utility/forward.h>
  205. #include <__utility/forward_like.h>
  206. #include <__utility/in_place.h>
  207. #include <__utility/integer_sequence.h>
  208. #include <__utility/move.h>
  209. #include <__utility/pair.h>
  210. #include <__utility/piecewise_construct.h>
  211. #include <__utility/priority_tag.h>
  212. #include <__utility/rel_ops.h>
  213. #include <__utility/swap.h>
  214. #include <__utility/to_underlying.h>
  215. #include <__utility/unreachable.h>
  216. #include <version>
  217. // standard-mandated includes
  218. // [utility.syn]
  219. #include <compare>
  220. #include <initializer_list>
  221. // [tuple.helper]
  222. #include <__tuple/tuple_element.h>
  223. #include <__tuple/tuple_size.h>
  224. #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
  225. # pragma GCC system_header
  226. #endif
  227. #if !defined(_LIBCPP_REMOVE_TRANSITIVE_INCLUDES) && _LIBCPP_STD_VER <= 20
  228. # include <cstdlib>
  229. # include <iosfwd>
  230. # include <type_traits>
  231. #endif
  232. #endif // _LIBCPP_UTILITY