array 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515
  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_ARRAY
  10. #define _LIBCPP_ARRAY
  11. /*
  12. array synopsis
  13. namespace std
  14. {
  15. template <class T, size_t N >
  16. struct array
  17. {
  18. // types:
  19. typedef T & reference;
  20. typedef const T & const_reference;
  21. typedef implementation defined iterator;
  22. typedef implementation defined const_iterator;
  23. typedef size_t size_type;
  24. typedef ptrdiff_t difference_type;
  25. typedef T value_type;
  26. typedef T* pointer;
  27. typedef const T* const_pointer;
  28. typedef std::reverse_iterator<iterator> reverse_iterator;
  29. typedef std::reverse_iterator<const_iterator> const_reverse_iterator;
  30. // No explicit construct/copy/destroy for aggregate type
  31. void fill(const T& u); // constexpr in C++20
  32. void swap(array& a) noexcept(is_nothrow_swappable_v<T>); // constexpr in C++20
  33. // iterators:
  34. iterator begin() noexcept; // constexpr in C++17
  35. const_iterator begin() const noexcept; // constexpr in C++17
  36. iterator end() noexcept; // constexpr in C++17
  37. const_iterator end() const noexcept; // constexpr in C++17
  38. reverse_iterator rbegin() noexcept; // constexpr in C++17
  39. const_reverse_iterator rbegin() const noexcept; // constexpr in C++17
  40. reverse_iterator rend() noexcept; // constexpr in C++17
  41. const_reverse_iterator rend() const noexcept; // constexpr in C++17
  42. const_iterator cbegin() const noexcept; // constexpr in C++17
  43. const_iterator cend() const noexcept; // constexpr in C++17
  44. const_reverse_iterator crbegin() const noexcept; // constexpr in C++17
  45. const_reverse_iterator crend() const noexcept; // constexpr in C++17
  46. // capacity:
  47. constexpr size_type size() const noexcept;
  48. constexpr size_type max_size() const noexcept;
  49. constexpr bool empty() const noexcept;
  50. // element access:
  51. reference operator[](size_type n); // constexpr in C++17
  52. const_reference operator[](size_type n) const; // constexpr in C++14
  53. reference at(size_type n); // constexpr in C++17
  54. const_reference at(size_type n) const; // constexpr in C++14
  55. reference front(); // constexpr in C++17
  56. const_reference front() const; // constexpr in C++14
  57. reference back(); // constexpr in C++17
  58. const_reference back() const; // constexpr in C++14
  59. T* data() noexcept; // constexpr in C++17
  60. const T* data() const noexcept; // constexpr in C++17
  61. };
  62. template <class T, class... U>
  63. array(T, U...) -> array<T, 1 + sizeof...(U)>; // C++17
  64. template <class T, size_t N>
  65. bool operator==(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20
  66. template <class T, size_t N>
  67. bool operator!=(const array<T,N>& x, const array<T,N>& y); // removed in C++20
  68. template <class T, size_t N>
  69. bool operator<(const array<T,N>& x, const array<T,N>& y); // removed in C++20
  70. template <class T, size_t N>
  71. bool operator>(const array<T,N>& x, const array<T,N>& y); // removed in C++20
  72. template <class T, size_t N>
  73. bool operator<=(const array<T,N>& x, const array<T,N>& y); // removed in C++20
  74. template <class T, size_t N>
  75. bool operator>=(const array<T,N>& x, const array<T,N>& y); // removed in C++20
  76. template<class T, size_t N>
  77. constexpr synth-three-way-result<T>
  78. operator<=>(const array<T, N>& x, const array<T, N>& y); // since C++20
  79. template <class T, size_t N >
  80. void swap(array<T,N>& x, array<T,N>& y) noexcept(noexcept(x.swap(y))); // constexpr in C++20
  81. template <class T, size_t N>
  82. constexpr array<remove_cv_t<T>, N> to_array(T (&a)[N]); // C++20
  83. template <class T, size_t N>
  84. constexpr array<remove_cv_t<T>, N> to_array(T (&&a)[N]); // C++20
  85. template <class T> struct tuple_size;
  86. template <size_t I, class T> struct tuple_element;
  87. template <class T, size_t N> struct tuple_size<array<T, N>>;
  88. template <size_t I, class T, size_t N> struct tuple_element<I, array<T, N>>;
  89. template <size_t I, class T, size_t N> T& get(array<T, N>&) noexcept; // constexpr in C++14
  90. template <size_t I, class T, size_t N> const T& get(const array<T, N>&) noexcept; // constexpr in C++14
  91. template <size_t I, class T, size_t N> T&& get(array<T, N>&&) noexcept; // constexpr in C++14
  92. template <size_t I, class T, size_t N> const T&& get(const array<T, N>&&) noexcept; // constexpr in C++14
  93. } // std
  94. */
  95. #include <__algorithm/equal.h>
  96. #include <__algorithm/fill_n.h>
  97. #include <__algorithm/lexicographical_compare.h>
  98. #include <__algorithm/lexicographical_compare_three_way.h>
  99. #include <__algorithm/swap_ranges.h>
  100. #include <__assert>
  101. #include <__config>
  102. #include <__fwd/array.h>
  103. #include <__iterator/reverse_iterator.h>
  104. #include <__iterator/wrap_iter.h>
  105. #include <__tuple/sfinae_helpers.h>
  106. #include <__type_traits/conditional.h>
  107. #include <__type_traits/conjunction.h>
  108. #include <__type_traits/is_array.h>
  109. #include <__type_traits/is_const.h>
  110. #include <__type_traits/is_constructible.h>
  111. #include <__type_traits/is_nothrow_constructible.h>
  112. #include <__type_traits/is_same.h>
  113. #include <__type_traits/is_swappable.h>
  114. #include <__type_traits/remove_cv.h>
  115. #include <__utility/empty.h>
  116. #include <__utility/integer_sequence.h>
  117. #include <__utility/move.h>
  118. #include <__utility/unreachable.h>
  119. #include <stdexcept>
  120. #include <version>
  121. // standard-mandated includes
  122. // [iterator.range]
  123. #include <__iterator/access.h>
  124. #include <__iterator/data.h>
  125. #include <__iterator/empty.h>
  126. #include <__iterator/reverse_access.h>
  127. #include <__iterator/size.h>
  128. // [array.syn]
  129. #include <compare>
  130. #include <initializer_list>
  131. // [tuple.helper]
  132. #include <__tuple/tuple_element.h>
  133. #include <__tuple/tuple_size.h>
  134. #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
  135. # pragma GCC system_header
  136. #endif
  137. _LIBCPP_PUSH_MACROS
  138. #include <__undef_macros>
  139. _LIBCPP_BEGIN_NAMESPACE_STD
  140. template <class _Tp, size_t _Size>
  141. struct _LIBCPP_TEMPLATE_VIS array {
  142. // types:
  143. using __self = array;
  144. using value_type = _Tp;
  145. using reference = value_type&;
  146. using const_reference = const value_type&;
  147. using pointer = value_type*;
  148. using const_pointer = const value_type*;
  149. #if defined(_LIBCPP_ABI_USE_WRAP_ITER_IN_STD_ARRAY)
  150. using iterator = __wrap_iter<pointer>;
  151. using const_iterator = __wrap_iter<const_pointer>;
  152. #else
  153. using iterator = pointer;
  154. using const_iterator = const_pointer;
  155. #endif
  156. using size_type = size_t;
  157. using difference_type = ptrdiff_t;
  158. using reverse_iterator = std::reverse_iterator<iterator>;
  159. using const_reverse_iterator = std::reverse_iterator<const_iterator>;
  160. _Tp __elems_[_Size];
  161. // No explicit construct/copy/destroy for aggregate type
  162. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX20 void fill(const value_type& __u) {
  163. std::fill_n(data(), _Size, __u);
  164. }
  165. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX20 void swap(array& __a)
  166. _NOEXCEPT_(__is_nothrow_swappable<_Tp>::value) {
  167. std::swap_ranges(data(), data() + _Size, __a.data());
  168. }
  169. // iterators:
  170. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 iterator begin() _NOEXCEPT { return iterator(data()); }
  171. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_iterator begin() const _NOEXCEPT {
  172. return const_iterator(data());
  173. }
  174. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 iterator end() _NOEXCEPT { return iterator(data() + _Size); }
  175. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_iterator end() const _NOEXCEPT {
  176. return const_iterator(data() + _Size);
  177. }
  178. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reverse_iterator rbegin() _NOEXCEPT {
  179. return reverse_iterator(end());
  180. }
  181. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_reverse_iterator rbegin() const _NOEXCEPT {
  182. return const_reverse_iterator(end());
  183. }
  184. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reverse_iterator rend() _NOEXCEPT {
  185. return reverse_iterator(begin());
  186. }
  187. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_reverse_iterator rend() const _NOEXCEPT {
  188. return const_reverse_iterator(begin());
  189. }
  190. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_iterator cbegin() const _NOEXCEPT { return begin(); }
  191. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_iterator cend() const _NOEXCEPT { return end(); }
  192. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_reverse_iterator crbegin() const _NOEXCEPT {
  193. return rbegin();
  194. }
  195. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_reverse_iterator crend() const _NOEXCEPT { return rend(); }
  196. // capacity:
  197. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR size_type size() const _NOEXCEPT { return _Size; }
  198. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR size_type max_size() const _NOEXCEPT { return _Size; }
  199. _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR bool empty() const _NOEXCEPT {
  200. return _Size == 0;
  201. }
  202. // element access:
  203. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reference operator[](size_type __n) _NOEXCEPT {
  204. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(__n < _Size, "out-of-bounds access in std::array<T, N>");
  205. return __elems_[__n];
  206. }
  207. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference operator[](size_type __n) const _NOEXCEPT {
  208. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(__n < _Size, "out-of-bounds access in std::array<T, N>");
  209. return __elems_[__n];
  210. }
  211. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reference at(size_type __n) {
  212. if (__n >= _Size)
  213. __throw_out_of_range("array::at");
  214. return __elems_[__n];
  215. }
  216. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference at(size_type __n) const {
  217. if (__n >= _Size)
  218. __throw_out_of_range("array::at");
  219. return __elems_[__n];
  220. }
  221. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reference front() _NOEXCEPT { return (*this)[0]; }
  222. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference front() const _NOEXCEPT { return (*this)[0]; }
  223. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reference back() _NOEXCEPT { return (*this)[_Size - 1]; }
  224. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference back() const _NOEXCEPT {
  225. return (*this)[_Size - 1];
  226. }
  227. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 value_type* data() _NOEXCEPT { return __elems_; }
  228. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const value_type* data() const _NOEXCEPT { return __elems_; }
  229. };
  230. template <class _Tp>
  231. struct _LIBCPP_TEMPLATE_VIS array<_Tp, 0> {
  232. // types:
  233. typedef array __self;
  234. typedef _Tp value_type;
  235. typedef value_type& reference;
  236. typedef const value_type& const_reference;
  237. typedef value_type* iterator;
  238. typedef const value_type* const_iterator;
  239. typedef value_type* pointer;
  240. typedef const value_type* const_pointer;
  241. typedef size_t size_type;
  242. typedef ptrdiff_t difference_type;
  243. typedef std::reverse_iterator<iterator> reverse_iterator;
  244. typedef std::reverse_iterator<const_iterator> const_reverse_iterator;
  245. typedef __conditional_t<is_const<_Tp>::value, const __empty, __empty> _EmptyType;
  246. struct _ArrayInStructT {
  247. _Tp __data_[1];
  248. };
  249. _ALIGNAS_TYPE(_ArrayInStructT) _EmptyType __elems_[sizeof(_ArrayInStructT)];
  250. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 value_type* data() _NOEXCEPT { return nullptr; }
  251. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const value_type* data() const _NOEXCEPT { return nullptr; }
  252. // No explicit construct/copy/destroy for aggregate type
  253. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX20 void fill(const value_type&) {
  254. static_assert(!is_const<_Tp>::value, "cannot fill zero-sized array of type 'const T'");
  255. }
  256. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX20 void swap(array&) _NOEXCEPT {
  257. static_assert(!is_const<_Tp>::value, "cannot swap zero-sized array of type 'const T'");
  258. }
  259. // iterators:
  260. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 iterator begin() _NOEXCEPT { return iterator(data()); }
  261. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_iterator begin() const _NOEXCEPT {
  262. return const_iterator(data());
  263. }
  264. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 iterator end() _NOEXCEPT { return iterator(data()); }
  265. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_iterator end() const _NOEXCEPT {
  266. return const_iterator(data());
  267. }
  268. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reverse_iterator rbegin() _NOEXCEPT {
  269. return reverse_iterator(end());
  270. }
  271. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_reverse_iterator rbegin() const _NOEXCEPT {
  272. return const_reverse_iterator(end());
  273. }
  274. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reverse_iterator rend() _NOEXCEPT {
  275. return reverse_iterator(begin());
  276. }
  277. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_reverse_iterator rend() const _NOEXCEPT {
  278. return const_reverse_iterator(begin());
  279. }
  280. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_iterator cbegin() const _NOEXCEPT { return begin(); }
  281. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_iterator cend() const _NOEXCEPT { return end(); }
  282. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_reverse_iterator crbegin() const _NOEXCEPT {
  283. return rbegin();
  284. }
  285. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 const_reverse_iterator crend() const _NOEXCEPT { return rend(); }
  286. // capacity:
  287. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR size_type size() const _NOEXCEPT { return 0; }
  288. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR size_type max_size() const _NOEXCEPT { return 0; }
  289. _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR bool empty() const _NOEXCEPT { return true; }
  290. // element access:
  291. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reference operator[](size_type) _NOEXCEPT {
  292. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::operator[] on a zero-sized array");
  293. __libcpp_unreachable();
  294. }
  295. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference operator[](size_type) const _NOEXCEPT {
  296. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::operator[] on a zero-sized array");
  297. __libcpp_unreachable();
  298. }
  299. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reference at(size_type) {
  300. __throw_out_of_range("array<T, 0>::at");
  301. __libcpp_unreachable();
  302. }
  303. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference at(size_type) const {
  304. __throw_out_of_range("array<T, 0>::at");
  305. __libcpp_unreachable();
  306. }
  307. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reference front() _NOEXCEPT {
  308. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::front() on a zero-sized array");
  309. __libcpp_unreachable();
  310. }
  311. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference front() const _NOEXCEPT {
  312. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::front() on a zero-sized array");
  313. __libcpp_unreachable();
  314. }
  315. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reference back() _NOEXCEPT {
  316. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::back() on a zero-sized array");
  317. __libcpp_unreachable();
  318. }
  319. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference back() const _NOEXCEPT {
  320. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::back() on a zero-sized array");
  321. __libcpp_unreachable();
  322. }
  323. };
  324. #if _LIBCPP_STD_VER >= 17
  325. template <class _Tp, class... _Args, class = enable_if_t<__all<_IsSame<_Tp, _Args>::value...>::value> >
  326. array(_Tp, _Args...) -> array<_Tp, 1 + sizeof...(_Args)>;
  327. #endif
  328. template <class _Tp, size_t _Size>
  329. inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX20 bool
  330. operator==(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  331. return std::equal(__x.begin(), __x.end(), __y.begin());
  332. }
  333. #if _LIBCPP_STD_VER <= 17
  334. template <class _Tp, size_t _Size>
  335. inline _LIBCPP_HIDE_FROM_ABI bool operator!=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  336. return !(__x == __y);
  337. }
  338. template <class _Tp, size_t _Size>
  339. inline _LIBCPP_HIDE_FROM_ABI bool operator<(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  340. return std::lexicographical_compare(__x.begin(), __x.end(), __y.begin(), __y.end());
  341. }
  342. template <class _Tp, size_t _Size>
  343. inline _LIBCPP_HIDE_FROM_ABI bool operator>(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  344. return __y < __x;
  345. }
  346. template <class _Tp, size_t _Size>
  347. inline _LIBCPP_HIDE_FROM_ABI bool operator<=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  348. return !(__y < __x);
  349. }
  350. template <class _Tp, size_t _Size>
  351. inline _LIBCPP_HIDE_FROM_ABI bool operator>=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  352. return !(__x < __y);
  353. }
  354. #else // _LIBCPP_STD_VER <= 17
  355. template <class _Tp, size_t _Size>
  356. _LIBCPP_HIDE_FROM_ABI constexpr __synth_three_way_result<_Tp>
  357. operator<=>(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  358. return std::lexicographical_compare_three_way(
  359. __x.begin(), __x.end(), __y.begin(), __y.end(), std::__synth_three_way<_Tp, _Tp>);
  360. }
  361. #endif // _LIBCPP_STD_VER <= 17
  362. template <class _Tp, size_t _Size, __enable_if_t<_Size == 0 || __is_swappable<_Tp>::value, int> = 0>
  363. inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX20 void swap(array<_Tp, _Size>& __x, array<_Tp, _Size>& __y)
  364. _NOEXCEPT_(noexcept(__x.swap(__y))) {
  365. __x.swap(__y);
  366. }
  367. template <class _Tp, size_t _Size>
  368. struct _LIBCPP_TEMPLATE_VIS tuple_size<array<_Tp, _Size> > : public integral_constant<size_t, _Size> {};
  369. template <size_t _Ip, class _Tp, size_t _Size>
  370. struct _LIBCPP_TEMPLATE_VIS tuple_element<_Ip, array<_Tp, _Size> > {
  371. static_assert(_Ip < _Size, "Index out of bounds in std::tuple_element<> (std::array)");
  372. typedef _Tp type;
  373. };
  374. template <size_t _Ip, class _Tp, size_t _Size>
  375. inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 _Tp& get(array<_Tp, _Size>& __a) _NOEXCEPT {
  376. static_assert(_Ip < _Size, "Index out of bounds in std::get<> (std::array)");
  377. return __a.__elems_[_Ip];
  378. }
  379. template <size_t _Ip, class _Tp, size_t _Size>
  380. inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const _Tp& get(const array<_Tp, _Size>& __a) _NOEXCEPT {
  381. static_assert(_Ip < _Size, "Index out of bounds in std::get<> (const std::array)");
  382. return __a.__elems_[_Ip];
  383. }
  384. template <size_t _Ip, class _Tp, size_t _Size>
  385. inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 _Tp&& get(array<_Tp, _Size>&& __a) _NOEXCEPT {
  386. static_assert(_Ip < _Size, "Index out of bounds in std::get<> (std::array &&)");
  387. return std::move(__a.__elems_[_Ip]);
  388. }
  389. template <size_t _Ip, class _Tp, size_t _Size>
  390. inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const _Tp&& get(const array<_Tp, _Size>&& __a) _NOEXCEPT {
  391. static_assert(_Ip < _Size, "Index out of bounds in std::get<> (const std::array &&)");
  392. return std::move(__a.__elems_[_Ip]);
  393. }
  394. #if _LIBCPP_STD_VER >= 20
  395. template <typename _Tp, size_t _Size, size_t... _Index>
  396. _LIBCPP_HIDE_FROM_ABI constexpr array<remove_cv_t<_Tp>, _Size>
  397. __to_array_lvalue_impl(_Tp (&__arr)[_Size], index_sequence<_Index...>) {
  398. return {{__arr[_Index]...}};
  399. }
  400. template <typename _Tp, size_t _Size, size_t... _Index>
  401. _LIBCPP_HIDE_FROM_ABI constexpr array<remove_cv_t<_Tp>, _Size>
  402. __to_array_rvalue_impl(_Tp (&&__arr)[_Size], index_sequence<_Index...>) {
  403. return {{std::move(__arr[_Index])...}};
  404. }
  405. template <typename _Tp, size_t _Size>
  406. _LIBCPP_HIDE_FROM_ABI constexpr array<remove_cv_t<_Tp>, _Size>
  407. to_array(_Tp (&__arr)[_Size]) noexcept(is_nothrow_constructible_v<_Tp, _Tp&>) {
  408. static_assert(!is_array_v<_Tp>, "[array.creation]/1: to_array does not accept multidimensional arrays.");
  409. static_assert(is_constructible_v<_Tp, _Tp&>, "[array.creation]/1: to_array requires copy constructible elements.");
  410. return std::__to_array_lvalue_impl(__arr, make_index_sequence<_Size>());
  411. }
  412. template <typename _Tp, size_t _Size>
  413. _LIBCPP_HIDE_FROM_ABI constexpr array<remove_cv_t<_Tp>, _Size>
  414. to_array(_Tp (&&__arr)[_Size]) noexcept(is_nothrow_move_constructible_v<_Tp>) {
  415. static_assert(!is_array_v<_Tp>, "[array.creation]/4: to_array does not accept multidimensional arrays.");
  416. static_assert(is_move_constructible_v<_Tp>, "[array.creation]/4: to_array requires move constructible elements.");
  417. return std::__to_array_rvalue_impl(std::move(__arr), make_index_sequence<_Size>());
  418. }
  419. #endif // _LIBCPP_STD_VER >= 20
  420. _LIBCPP_END_NAMESPACE_STD
  421. _LIBCPP_POP_MACROS
  422. #if !defined(_LIBCPP_REMOVE_TRANSITIVE_INCLUDES) && _LIBCPP_STD_VER <= 20
  423. # include <algorithm>
  424. # include <concepts>
  425. # include <cstdlib>
  426. # include <iterator>
  427. # include <type_traits>
  428. # include <utility>
  429. #endif
  430. #endif // _LIBCPP_ARRAY