array 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555
  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> // all public C++ headers provide the assertion handler
  101. #include <__config>
  102. #include <__fwd/array.h>
  103. #include <__iterator/reverse_iterator.h>
  104. #include <__tuple/sfinae_helpers.h>
  105. #include <__type_traits/conditional.h>
  106. #include <__type_traits/is_array.h>
  107. #include <__type_traits/is_const.h>
  108. #include <__type_traits/is_constructible.h>
  109. #include <__type_traits/is_move_constructible.h>
  110. #include <__type_traits/is_nothrow_constructible.h>
  111. #include <__type_traits/is_nothrow_move_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/integer_sequence.h>
  116. #include <__utility/move.h>
  117. #include <__utility/unreachable.h>
  118. #include <stdexcept>
  119. #include <version>
  120. // standard-mandated includes
  121. // [iterator.range]
  122. #include <__iterator/access.h>
  123. #include <__iterator/data.h>
  124. #include <__iterator/empty.h>
  125. #include <__iterator/reverse_access.h>
  126. #include <__iterator/size.h>
  127. // [array.syn]
  128. #include <compare>
  129. #include <initializer_list>
  130. // [tuple.helper]
  131. #include <__tuple/tuple_element.h>
  132. #include <__tuple/tuple_size.h>
  133. #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
  134. # pragma GCC system_header
  135. #endif
  136. _LIBCPP_BEGIN_NAMESPACE_STD
  137. template <class _Tp, size_t _Size>
  138. struct _LIBCPP_TEMPLATE_VIS array
  139. {
  140. // types:
  141. typedef array __self;
  142. typedef _Tp value_type;
  143. typedef value_type& reference;
  144. typedef const value_type& const_reference;
  145. typedef value_type* iterator;
  146. typedef const value_type* const_iterator;
  147. typedef value_type* pointer;
  148. typedef const value_type* const_pointer;
  149. typedef size_t size_type;
  150. typedef ptrdiff_t difference_type;
  151. typedef _VSTD::reverse_iterator<iterator> reverse_iterator;
  152. typedef _VSTD::reverse_iterator<const_iterator> const_reverse_iterator;
  153. _Tp __elems_[_Size];
  154. // No explicit construct/copy/destroy for aggregate type
  155. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX20
  156. void fill(const value_type& __u) {
  157. _VSTD::fill_n(data(), _Size, __u);
  158. }
  159. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX20
  160. void swap(array& __a) _NOEXCEPT_(__is_nothrow_swappable<_Tp>::value) {
  161. _VSTD::swap_ranges(data(), data() + _Size, __a.data());
  162. }
  163. // iterators:
  164. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  165. iterator begin() _NOEXCEPT {return iterator(data());}
  166. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  167. const_iterator begin() const _NOEXCEPT {return const_iterator(data());}
  168. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  169. iterator end() _NOEXCEPT {return iterator(data() + _Size);}
  170. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  171. const_iterator end() const _NOEXCEPT {return const_iterator(data() + _Size);}
  172. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  173. reverse_iterator rbegin() _NOEXCEPT {return reverse_iterator(end());}
  174. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  175. const_reverse_iterator rbegin() const _NOEXCEPT {return const_reverse_iterator(end());}
  176. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  177. reverse_iterator rend() _NOEXCEPT {return reverse_iterator(begin());}
  178. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  179. const_reverse_iterator rend() const _NOEXCEPT {return const_reverse_iterator(begin());}
  180. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  181. const_iterator cbegin() const _NOEXCEPT {return begin();}
  182. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  183. const_iterator cend() const _NOEXCEPT {return end();}
  184. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  185. const_reverse_iterator crbegin() const _NOEXCEPT {return rbegin();}
  186. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  187. const_reverse_iterator crend() const _NOEXCEPT {return rend();}
  188. // capacity:
  189. _LIBCPP_INLINE_VISIBILITY
  190. _LIBCPP_CONSTEXPR size_type size() const _NOEXCEPT {return _Size;}
  191. _LIBCPP_INLINE_VISIBILITY
  192. _LIBCPP_CONSTEXPR size_type max_size() const _NOEXCEPT {return _Size;}
  193. _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_INLINE_VISIBILITY
  194. _LIBCPP_CONSTEXPR bool empty() const _NOEXCEPT {return _Size == 0;}
  195. // element access:
  196. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  197. reference operator[](size_type __n) _NOEXCEPT {
  198. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(__n < _Size, "out-of-bounds access in std::array<T, N>");
  199. return __elems_[__n];
  200. }
  201. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14
  202. const_reference operator[](size_type __n) const _NOEXCEPT {
  203. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(__n < _Size, "out-of-bounds access in std::array<T, N>");
  204. return __elems_[__n];
  205. }
  206. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reference at(size_type __n)
  207. {
  208. if (__n >= _Size)
  209. __throw_out_of_range("array::at");
  210. return __elems_[__n];
  211. }
  212. _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference at(size_type __n) const
  213. {
  214. if (__n >= _Size)
  215. __throw_out_of_range("array::at");
  216. return __elems_[__n];
  217. }
  218. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17 reference front() _NOEXCEPT {return (*this)[0];}
  219. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference front() const _NOEXCEPT {return (*this)[0];}
  220. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17 reference back() _NOEXCEPT {return (*this)[_Size - 1];}
  221. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14 const_reference back() const _NOEXCEPT {return (*this)[_Size - 1];}
  222. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  223. value_type* data() _NOEXCEPT {return __elems_;}
  224. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  225. const value_type* data() const _NOEXCEPT {return __elems_;}
  226. };
  227. template <class _Tp>
  228. struct _LIBCPP_TEMPLATE_VIS array<_Tp, 0>
  229. {
  230. // types:
  231. typedef array __self;
  232. typedef _Tp value_type;
  233. typedef value_type& reference;
  234. typedef const value_type& const_reference;
  235. typedef value_type* iterator;
  236. typedef const value_type* const_iterator;
  237. typedef value_type* pointer;
  238. typedef const value_type* const_pointer;
  239. typedef size_t size_type;
  240. typedef ptrdiff_t difference_type;
  241. typedef _VSTD::reverse_iterator<iterator> reverse_iterator;
  242. typedef _VSTD::reverse_iterator<const_iterator> const_reverse_iterator;
  243. typedef __conditional_t<is_const<_Tp>::value, const char, char> _CharType;
  244. struct _ArrayInStructT { _Tp __data_[1]; };
  245. _ALIGNAS_TYPE(_ArrayInStructT) _CharType __elems_[sizeof(_ArrayInStructT)];
  246. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  247. value_type* data() _NOEXCEPT {return nullptr;}
  248. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  249. const value_type* data() const _NOEXCEPT {return nullptr;}
  250. // No explicit construct/copy/destroy for aggregate type
  251. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX20
  252. void fill(const value_type&) {
  253. static_assert(!is_const<_Tp>::value,
  254. "cannot fill zero-sized array of type 'const T'");
  255. }
  256. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX20
  257. void swap(array&) _NOEXCEPT {
  258. static_assert(!is_const<_Tp>::value,
  259. "cannot swap zero-sized array of type 'const T'");
  260. }
  261. // iterators:
  262. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  263. iterator begin() _NOEXCEPT {return iterator(data());}
  264. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  265. const_iterator begin() const _NOEXCEPT {return const_iterator(data());}
  266. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  267. iterator end() _NOEXCEPT {return iterator(data());}
  268. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  269. const_iterator end() const _NOEXCEPT {return const_iterator(data());}
  270. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  271. reverse_iterator rbegin() _NOEXCEPT {return reverse_iterator(end());}
  272. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  273. const_reverse_iterator rbegin() const _NOEXCEPT {return const_reverse_iterator(end());}
  274. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  275. reverse_iterator rend() _NOEXCEPT {return reverse_iterator(begin());}
  276. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  277. const_reverse_iterator rend() const _NOEXCEPT {return const_reverse_iterator(begin());}
  278. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  279. const_iterator cbegin() const _NOEXCEPT {return begin();}
  280. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  281. const_iterator cend() const _NOEXCEPT {return end();}
  282. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  283. const_reverse_iterator crbegin() const _NOEXCEPT {return rbegin();}
  284. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  285. const_reverse_iterator crend() const _NOEXCEPT {return rend();}
  286. // capacity:
  287. _LIBCPP_INLINE_VISIBILITY
  288. _LIBCPP_CONSTEXPR size_type size() const _NOEXCEPT {return 0; }
  289. _LIBCPP_INLINE_VISIBILITY
  290. _LIBCPP_CONSTEXPR size_type max_size() const _NOEXCEPT {return 0;}
  291. _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_INLINE_VISIBILITY
  292. _LIBCPP_CONSTEXPR bool empty() const _NOEXCEPT {return true;}
  293. // element access:
  294. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  295. reference operator[](size_type) _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_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14
  300. const_reference operator[](size_type) const _NOEXCEPT {
  301. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::operator[] on a zero-sized array");
  302. __libcpp_unreachable();
  303. }
  304. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  305. reference at(size_type) {
  306. __throw_out_of_range("array<T, 0>::at");
  307. __libcpp_unreachable();
  308. }
  309. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14
  310. const_reference at(size_type) const {
  311. __throw_out_of_range("array<T, 0>::at");
  312. __libcpp_unreachable();
  313. }
  314. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  315. reference front() _NOEXCEPT {
  316. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::front() on a zero-sized array");
  317. __libcpp_unreachable();
  318. }
  319. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14
  320. const_reference front() const _NOEXCEPT {
  321. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::front() on a zero-sized array");
  322. __libcpp_unreachable();
  323. }
  324. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX17
  325. reference back() _NOEXCEPT {
  326. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::back() on a zero-sized array");
  327. __libcpp_unreachable();
  328. }
  329. _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14
  330. const_reference back() const _NOEXCEPT {
  331. _LIBCPP_ASSERT_VALID_ELEMENT_ACCESS(false, "cannot call array<T, 0>::back() on a zero-sized array");
  332. __libcpp_unreachable();
  333. }
  334. };
  335. #if _LIBCPP_STD_VER >= 17
  336. template<class _Tp, class... _Args,
  337. class = enable_if_t<__all<_IsSame<_Tp, _Args>::value...>::value>
  338. >
  339. array(_Tp, _Args...)
  340. -> array<_Tp, 1 + sizeof...(_Args)>;
  341. #endif
  342. template <class _Tp, size_t _Size>
  343. inline _LIBCPP_INLINE_VISIBILITY
  344. _LIBCPP_CONSTEXPR_SINCE_CXX20 bool
  345. operator==(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y)
  346. {
  347. return _VSTD::equal(__x.begin(), __x.end(), __y.begin());
  348. }
  349. #if _LIBCPP_STD_VER <= 17
  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. template <class _Tp, size_t _Size>
  355. inline _LIBCPP_HIDE_FROM_ABI bool operator<(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  356. return _VSTD::lexicographical_compare(__x.begin(), __x.end(), __y.begin(), __y.end());
  357. }
  358. template <class _Tp, size_t _Size>
  359. inline _LIBCPP_HIDE_FROM_ABI bool operator>(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  360. return __y < __x;
  361. }
  362. template <class _Tp, size_t _Size>
  363. inline _LIBCPP_HIDE_FROM_ABI bool operator<=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  364. return !(__y < __x);
  365. }
  366. template <class _Tp, size_t _Size>
  367. inline _LIBCPP_HIDE_FROM_ABI bool operator>=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  368. return !(__x < __y);
  369. }
  370. #else // _LIBCPP_STD_VER <= 17
  371. template <class _Tp, size_t _Size>
  372. _LIBCPP_HIDE_FROM_ABI constexpr __synth_three_way_result<_Tp>
  373. operator<=>(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) {
  374. return std::lexicographical_compare_three_way(
  375. __x.begin(), __x.end(), __y.begin(), __y.end(), std::__synth_three_way<_Tp, _Tp>);
  376. }
  377. #endif // _LIBCPP_STD_VER <= 17
  378. template <class _Tp, size_t _Size, __enable_if_t<_Size == 0 || __is_swappable<_Tp>::value, int> = 0>
  379. inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX20
  380. void
  381. swap(array<_Tp, _Size>& __x, array<_Tp, _Size>& __y)
  382. _NOEXCEPT_(noexcept(__x.swap(__y)))
  383. {
  384. __x.swap(__y);
  385. }
  386. template <class _Tp, size_t _Size>
  387. struct _LIBCPP_TEMPLATE_VIS tuple_size<array<_Tp, _Size> >
  388. : public integral_constant<size_t, _Size> {};
  389. template <size_t _Ip, class _Tp, size_t _Size>
  390. struct _LIBCPP_TEMPLATE_VIS tuple_element<_Ip, array<_Tp, _Size> >
  391. {
  392. static_assert(_Ip < _Size, "Index out of bounds in std::tuple_element<> (std::array)");
  393. typedef _Tp type;
  394. };
  395. template <size_t _Ip, class _Tp, size_t _Size>
  396. inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14
  397. _Tp&
  398. get(array<_Tp, _Size>& __a) _NOEXCEPT
  399. {
  400. static_assert(_Ip < _Size, "Index out of bounds in std::get<> (std::array)");
  401. return __a.__elems_[_Ip];
  402. }
  403. template <size_t _Ip, class _Tp, size_t _Size>
  404. inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14
  405. const _Tp&
  406. get(const array<_Tp, _Size>& __a) _NOEXCEPT
  407. {
  408. static_assert(_Ip < _Size, "Index out of bounds in std::get<> (const std::array)");
  409. return __a.__elems_[_Ip];
  410. }
  411. template <size_t _Ip, class _Tp, size_t _Size>
  412. inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14
  413. _Tp&&
  414. get(array<_Tp, _Size>&& __a) _NOEXCEPT
  415. {
  416. static_assert(_Ip < _Size, "Index out of bounds in std::get<> (std::array &&)");
  417. return _VSTD::move(__a.__elems_[_Ip]);
  418. }
  419. template <size_t _Ip, class _Tp, size_t _Size>
  420. inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_SINCE_CXX14
  421. const _Tp&&
  422. get(const array<_Tp, _Size>&& __a) _NOEXCEPT
  423. {
  424. static_assert(_Ip < _Size, "Index out of bounds in std::get<> (const std::array &&)");
  425. return _VSTD::move(__a.__elems_[_Ip]);
  426. }
  427. #if _LIBCPP_STD_VER >= 20
  428. template <typename _Tp, size_t _Size, size_t... _Index>
  429. _LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size>
  430. __to_array_lvalue_impl(_Tp (&__arr)[_Size], index_sequence<_Index...>) {
  431. return {{__arr[_Index]...}};
  432. }
  433. template <typename _Tp, size_t _Size, size_t... _Index>
  434. _LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size>
  435. __to_array_rvalue_impl(_Tp(&&__arr)[_Size], index_sequence<_Index...>) {
  436. return {{_VSTD::move(__arr[_Index])...}};
  437. }
  438. template <typename _Tp, size_t _Size>
  439. _LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size>
  440. to_array(_Tp (&__arr)[_Size]) noexcept(is_nothrow_constructible_v<_Tp, _Tp&>) {
  441. static_assert(
  442. !is_array_v<_Tp>,
  443. "[array.creation]/1: to_array does not accept multidimensional arrays.");
  444. static_assert(
  445. is_constructible_v<_Tp, _Tp&>,
  446. "[array.creation]/1: to_array requires copy constructible elements.");
  447. return _VSTD::__to_array_lvalue_impl(__arr, make_index_sequence<_Size>());
  448. }
  449. template <typename _Tp, size_t _Size>
  450. _LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size>
  451. to_array(_Tp(&&__arr)[_Size]) noexcept(is_nothrow_move_constructible_v<_Tp>) {
  452. static_assert(
  453. !is_array_v<_Tp>,
  454. "[array.creation]/4: to_array does not accept multidimensional arrays.");
  455. static_assert(
  456. is_move_constructible_v<_Tp>,
  457. "[array.creation]/4: to_array requires move constructible elements.");
  458. return _VSTD::__to_array_rvalue_impl(_VSTD::move(__arr),
  459. make_index_sequence<_Size>());
  460. }
  461. #endif // _LIBCPP_STD_VER >= 20
  462. _LIBCPP_END_NAMESPACE_STD
  463. #if !defined(_LIBCPP_REMOVE_TRANSITIVE_INCLUDES) && _LIBCPP_STD_VER <= 20
  464. # include <algorithm>
  465. # include <concepts>
  466. # include <cstdlib>
  467. # include <iterator>
  468. # include <type_traits>
  469. # include <utility>
  470. #endif
  471. #endif // _LIBCPP_ARRAY