13e519524SHoward Hinnant// -*- C++ -*- 2eb8650a7SLouis Dionne//===----------------------------------------------------------------------===// 33e519524SHoward Hinnant// 457b08b09SChandler Carruth// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 557b08b09SChandler Carruth// See https://llvm.org/LICENSE.txt for license information. 657b08b09SChandler Carruth// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 73e519524SHoward Hinnant// 83e519524SHoward Hinnant//===----------------------------------------------------------------------===// 93e519524SHoward Hinnant 103e519524SHoward Hinnant#ifndef _LIBCPP_ARRAY 113e519524SHoward Hinnant#define _LIBCPP_ARRAY 123e519524SHoward Hinnant 133e519524SHoward Hinnant/* 143e519524SHoward Hinnant array synopsis 153e519524SHoward Hinnant 163e519524SHoward Hinnantnamespace std 173e519524SHoward Hinnant{ 183e519524SHoward Hinnanttemplate <class T, size_t N > 193e519524SHoward Hinnantstruct array 203e519524SHoward Hinnant{ 213e519524SHoward Hinnant // types: 223e519524SHoward Hinnant typedef T & reference; 233e519524SHoward Hinnant typedef const T & const_reference; 243e519524SHoward Hinnant typedef implementation defined iterator; 253e519524SHoward Hinnant typedef implementation defined const_iterator; 263e519524SHoward Hinnant typedef size_t size_type; 273e519524SHoward Hinnant typedef ptrdiff_t difference_type; 283e519524SHoward Hinnant typedef T value_type; 293e519524SHoward Hinnant typedef T* pointer; 303e519524SHoward Hinnant typedef const T* const_pointer; 313e519524SHoward Hinnant typedef std::reverse_iterator<iterator> reverse_iterator; 323e519524SHoward Hinnant typedef std::reverse_iterator<const_iterator> const_reverse_iterator; 333e519524SHoward Hinnant 343e519524SHoward Hinnant // No explicit construct/copy/destroy for aggregate type 3577b9abfcSLouis Dionne void fill(const T& u); // constexpr in C++20 3677b9abfcSLouis Dionne void swap(array& a) noexcept(is_nothrow_swappable_v<T>); // constexpr in C++20 373e519524SHoward Hinnant 383e519524SHoward Hinnant // iterators: 3977b9abfcSLouis Dionne iterator begin() noexcept; // constexpr in C++17 4077b9abfcSLouis Dionne const_iterator begin() const noexcept; // constexpr in C++17 4177b9abfcSLouis Dionne iterator end() noexcept; // constexpr in C++17 4277b9abfcSLouis Dionne const_iterator end() const noexcept; // constexpr in C++17 433e519524SHoward Hinnant 4477b9abfcSLouis Dionne reverse_iterator rbegin() noexcept; // constexpr in C++17 4577b9abfcSLouis Dionne const_reverse_iterator rbegin() const noexcept; // constexpr in C++17 4677b9abfcSLouis Dionne reverse_iterator rend() noexcept; // constexpr in C++17 4777b9abfcSLouis Dionne const_reverse_iterator rend() const noexcept; // constexpr in C++17 483e519524SHoward Hinnant 4977b9abfcSLouis Dionne const_iterator cbegin() const noexcept; // constexpr in C++17 5077b9abfcSLouis Dionne const_iterator cend() const noexcept; // constexpr in C++17 5177b9abfcSLouis Dionne const_reverse_iterator crbegin() const noexcept; // constexpr in C++17 5277b9abfcSLouis Dionne const_reverse_iterator crend() const noexcept; // constexpr in C++17 533e519524SHoward Hinnant 543e519524SHoward Hinnant // capacity: 558f0cd597SHoward Hinnant constexpr size_type size() const noexcept; 568f0cd597SHoward Hinnant constexpr size_type max_size() const noexcept; 57397717b7SHoward Hinnant constexpr bool empty() const noexcept; 583e519524SHoward Hinnant 593e519524SHoward Hinnant // element access: 6077b9abfcSLouis Dionne reference operator[](size_type n); // constexpr in C++17 618bf1f08aSMarshall Clow const_reference operator[](size_type n) const; // constexpr in C++14 6277b9abfcSLouis Dionne reference at(size_type n); // constexpr in C++17 638bf1f08aSMarshall Clow const_reference at(size_type n) const; // constexpr in C++14 643e519524SHoward Hinnant 6577b9abfcSLouis Dionne reference front(); // constexpr in C++17 668bf1f08aSMarshall Clow const_reference front() const; // constexpr in C++14 6777b9abfcSLouis Dionne reference back(); // constexpr in C++17 688bf1f08aSMarshall Clow const_reference back() const; // constexpr in C++14 693e519524SHoward Hinnant 7077b9abfcSLouis Dionne T* data() noexcept; // constexpr in C++17 7177b9abfcSLouis Dionne const T* data() const noexcept; // constexpr in C++17 723e519524SHoward Hinnant}; 733e519524SHoward Hinnant 740ca8c089SMarshall Clowtemplate <class T, class... U> 7577b9abfcSLouis Dionne array(T, U...) -> array<T, 1 + sizeof...(U)>; // C++17 760ca8c089SMarshall Clow 773e519524SHoward Hinnanttemplate <class T, size_t N> 7877b9abfcSLouis Dionne bool operator==(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 793e519524SHoward Hinnanttemplate <class T, size_t N> 8077b9abfcSLouis Dionne bool operator!=(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 813e519524SHoward Hinnanttemplate <class T, size_t N> 8277b9abfcSLouis Dionne bool operator<(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 833e519524SHoward Hinnanttemplate <class T, size_t N> 8477b9abfcSLouis Dionne bool operator>(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 853e519524SHoward Hinnanttemplate <class T, size_t N> 8677b9abfcSLouis Dionne bool operator<=(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 873e519524SHoward Hinnanttemplate <class T, size_t N> 8877b9abfcSLouis Dionne bool operator>=(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 893e519524SHoward Hinnant 903e519524SHoward Hinnanttemplate <class T, size_t N > 9177b9abfcSLouis Dionne void swap(array<T,N>& x, array<T,N>& y) noexcept(noexcept(x.swap(y))); // constexpr in C++20 9277b9abfcSLouis Dionne 9377b9abfcSLouis Dionnetemplate <class T, size_t N> 9477b9abfcSLouis Dionne constexpr array<remove_cv_t<T>, N> to_array(T (&a)[N]); // C++20 9577b9abfcSLouis Dionnetemplate <class T, size_t N> 9677b9abfcSLouis Dionne constexpr array<remove_cv_t<T>, N> to_array(T (&&a)[N]); // C++20 973e519524SHoward Hinnant 98e4957601SMarshall Clowtemplate <class T> struct tuple_size; 992b0c7abbSLouis Dionnetemplate <size_t I, class T> struct tuple_element; 1003e519524SHoward Hinnanttemplate <class T, size_t N> struct tuple_size<array<T, N>>; 1015fcc8169SMarshall Clowtemplate <size_t I, class T, size_t N> struct tuple_element<I, array<T, N>>; 1025fcc8169SMarshall Clowtemplate <size_t I, class T, size_t N> T& get(array<T, N>&) noexcept; // constexpr in C++14 1035fcc8169SMarshall Clowtemplate <size_t I, class T, size_t N> const T& get(const array<T, N>&) noexcept; // constexpr in C++14 1045fcc8169SMarshall Clowtemplate <size_t I, class T, size_t N> T&& get(array<T, N>&&) noexcept; // constexpr in C++14 105545b8861SEric Fiseliertemplate <size_t I, class T, size_t N> const T&& get(const array<T, N>&&) noexcept; // constexpr in C++14 1063e519524SHoward Hinnant 1073e519524SHoward Hinnant} // std 1083e519524SHoward Hinnant 1093e519524SHoward Hinnant*/ 1103e519524SHoward Hinnant 1112e2f3158SNikolas Klauser#include <__algorithm/equal.h> 1122e2f3158SNikolas Klauser#include <__algorithm/fill_n.h> 1132e2f3158SNikolas Klauser#include <__algorithm/lexicographical_compare.h> 1142e2f3158SNikolas Klauser#include <__algorithm/swap_ranges.h> 115385cc25aSLouis Dionne#include <__assert> // all public C++ headers provide the assertion handler 1163e519524SHoward Hinnant#include <__config> 117*3cd4531bSNikolas Klauser#include <__iterator/reverse_iterator.h> 1183e519524SHoward Hinnant#include <__tuple> 11952915d78SNikolas Klauser#include <__utility/integer_sequence.h> 12052915d78SNikolas Klauser#include <__utility/move.h> 1212a8f9a5eSNikolas Klauser#include <__utility/unreachable.h> 122*3cd4531bSNikolas Klauser#include <compare> 123*3cd4531bSNikolas Klauser#include <iterator> // TODO: Remove this include 124bfbd73f8SArthur O'Dwyer#include <stdexcept> 1253e519524SHoward Hinnant#include <type_traits> 126f56972e2SMarshall Clow#include <version> 1273e519524SHoward Hinnant 128073458b1SHoward Hinnant#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER) 1293e519524SHoward Hinnant# pragma GCC system_header 130073458b1SHoward Hinnant#endif 1313e519524SHoward Hinnant 1323e519524SHoward Hinnant_LIBCPP_BEGIN_NAMESPACE_STD 1333e519524SHoward Hinnant 1343e519524SHoward Hinnanttemplate <class _Tp, size_t _Size> 135e2f2d1edSEric Fiselierstruct _LIBCPP_TEMPLATE_VIS array 1363e519524SHoward Hinnant{ 1373e519524SHoward Hinnant // types: 1383e519524SHoward Hinnant typedef array __self; 1393e519524SHoward Hinnant typedef _Tp value_type; 1403e519524SHoward Hinnant typedef value_type& reference; 1413e519524SHoward Hinnant typedef const value_type& const_reference; 1423e519524SHoward Hinnant typedef value_type* iterator; 1433e519524SHoward Hinnant typedef const value_type* const_iterator; 1443e519524SHoward Hinnant typedef value_type* pointer; 1453e519524SHoward Hinnant typedef const value_type* const_pointer; 1463e519524SHoward Hinnant typedef size_t size_type; 1473e519524SHoward Hinnant typedef ptrdiff_t difference_type; 148d586f92cSArthur O'Dwyer typedef _VSTD::reverse_iterator<iterator> reverse_iterator; 149d586f92cSArthur O'Dwyer typedef _VSTD::reverse_iterator<const_iterator> const_reverse_iterator; 1503e519524SHoward Hinnant 15159cdf90aSEric Fiselier _Tp __elems_[_Size]; 1523e519524SHoward Hinnant 1533e519524SHoward Hinnant // No explicit construct/copy/destroy for aggregate type 15477b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 15577b9abfcSLouis Dionne void fill(const value_type& __u) { 15666a14d15SLouis Dionne _VSTD::fill_n(data(), _Size, __u); 15759cdf90aSEric Fiselier } 158afeda5c2SEric Fiselier 15977b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 16059cdf90aSEric Fiselier void swap(array& __a) _NOEXCEPT_(__is_nothrow_swappable<_Tp>::value) { 161d586f92cSArthur O'Dwyer _VSTD::swap_ranges(data(), data() + _Size, __a.data()); 16259cdf90aSEric Fiselier } 1633e519524SHoward Hinnant 1643e519524SHoward Hinnant // iterators: 165020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 16659cdf90aSEric Fiselier iterator begin() _NOEXCEPT {return iterator(data());} 167020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 16859cdf90aSEric Fiselier const_iterator begin() const _NOEXCEPT {return const_iterator(data());} 169020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 17059cdf90aSEric Fiselier iterator end() _NOEXCEPT {return iterator(data() + _Size);} 171020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 17259cdf90aSEric Fiselier const_iterator end() const _NOEXCEPT {return const_iterator(data() + _Size);} 1733e519524SHoward Hinnant 174020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1758f0cd597SHoward Hinnant reverse_iterator rbegin() _NOEXCEPT {return reverse_iterator(end());} 176020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1778f0cd597SHoward Hinnant const_reverse_iterator rbegin() const _NOEXCEPT {return const_reverse_iterator(end());} 178020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1798f0cd597SHoward Hinnant reverse_iterator rend() _NOEXCEPT {return reverse_iterator(begin());} 180020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1818f0cd597SHoward Hinnant const_reverse_iterator rend() const _NOEXCEPT {return const_reverse_iterator(begin());} 1823e519524SHoward Hinnant 183020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1848f0cd597SHoward Hinnant const_iterator cbegin() const _NOEXCEPT {return begin();} 185020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1868f0cd597SHoward Hinnant const_iterator cend() const _NOEXCEPT {return end();} 187020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1888f0cd597SHoward Hinnant const_reverse_iterator crbegin() const _NOEXCEPT {return rbegin();} 189020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1908f0cd597SHoward Hinnant const_reverse_iterator crend() const _NOEXCEPT {return rend();} 1913e519524SHoward Hinnant 1923e519524SHoward Hinnant // capacity: 1938f0cd597SHoward Hinnant _LIBCPP_INLINE_VISIBILITY 194397717b7SHoward Hinnant _LIBCPP_CONSTEXPR size_type size() const _NOEXCEPT {return _Size;} 1958f0cd597SHoward Hinnant _LIBCPP_INLINE_VISIBILITY 196397717b7SHoward Hinnant _LIBCPP_CONSTEXPR size_type max_size() const _NOEXCEPT {return _Size;} 19772c8fad4SMarshall Clow _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_INLINE_VISIBILITY 19866a14d15SLouis Dionne _LIBCPP_CONSTEXPR bool empty() const _NOEXCEPT {return _Size == 0;} 1993e519524SHoward Hinnant 2003e519524SHoward Hinnant // element access: 201e7826950SMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 20223776a17SLouis Dionne reference operator[](size_type __n) _NOEXCEPT { 20323776a17SLouis Dionne _LIBCPP_ASSERT(__n < _Size, "out-of-bounds access in std::array<T, N>"); 20423776a17SLouis Dionne return __elems_[__n]; 20523776a17SLouis Dionne } 206e7826950SMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 20723776a17SLouis Dionne const_reference operator[](size_type __n) const _NOEXCEPT { 20823776a17SLouis Dionne _LIBCPP_ASSERT(__n < _Size, "out-of-bounds access in std::array<T, N>"); 20923776a17SLouis Dionne return __elems_[__n]; 21023776a17SLouis Dionne } 211e7826950SMarshall Clow 2120161874cSLouis Dionne _LIBCPP_CONSTEXPR_AFTER_CXX14 reference at(size_type __n) 2130161874cSLouis Dionne { 2140161874cSLouis Dionne if (__n >= _Size) 2150161874cSLouis Dionne __throw_out_of_range("array::at"); 2160161874cSLouis Dionne return __elems_[__n]; 2170161874cSLouis Dionne } 2180161874cSLouis Dionne 2190161874cSLouis Dionne _LIBCPP_CONSTEXPR_AFTER_CXX11 const_reference at(size_type __n) const 2200161874cSLouis Dionne { 2210161874cSLouis Dionne if (__n >= _Size) 2220161874cSLouis Dionne __throw_out_of_range("array::at"); 2230161874cSLouis Dionne return __elems_[__n]; 2240161874cSLouis Dionne } 2253e519524SHoward Hinnant 22623776a17SLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 reference front() _NOEXCEPT {return (*this)[0];} 22723776a17SLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 const_reference front() const _NOEXCEPT {return (*this)[0];} 22823776a17SLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 reference back() _NOEXCEPT {return (*this)[_Size - 1];} 22923776a17SLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 const_reference back() const _NOEXCEPT {return (*this)[_Size - 1];} 2303e519524SHoward Hinnant 231020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 232936ff584SNirav Dave value_type* data() _NOEXCEPT {return __elems_;} 233020b623aSMarshall Clow _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 234936ff584SNirav Dave const value_type* data() const _NOEXCEPT {return __elems_;} 2353e519524SHoward Hinnant}; 2363e519524SHoward Hinnant 23759cdf90aSEric Fiseliertemplate <class _Tp> 23859cdf90aSEric Fiselierstruct _LIBCPP_TEMPLATE_VIS array<_Tp, 0> 23959cdf90aSEric Fiselier{ 24059cdf90aSEric Fiselier // types: 24159cdf90aSEric Fiselier typedef array __self; 24259cdf90aSEric Fiselier typedef _Tp value_type; 24359cdf90aSEric Fiselier typedef value_type& reference; 24459cdf90aSEric Fiselier typedef const value_type& const_reference; 24559cdf90aSEric Fiselier typedef value_type* iterator; 24659cdf90aSEric Fiselier typedef const value_type* const_iterator; 24759cdf90aSEric Fiselier typedef value_type* pointer; 24859cdf90aSEric Fiselier typedef const value_type* const_pointer; 24959cdf90aSEric Fiselier typedef size_t size_type; 25059cdf90aSEric Fiselier typedef ptrdiff_t difference_type; 251d586f92cSArthur O'Dwyer typedef _VSTD::reverse_iterator<iterator> reverse_iterator; 252d586f92cSArthur O'Dwyer typedef _VSTD::reverse_iterator<const_iterator> const_reverse_iterator; 25359cdf90aSEric Fiselier 25459cdf90aSEric Fiselier typedef typename conditional<is_const<_Tp>::value, const char, 25559cdf90aSEric Fiselier char>::type _CharType; 2561a78ae3cSEric Fiselier 2571a78ae3cSEric Fiselier struct _ArrayInStructT { _Tp __data_[1]; }; 2581a78ae3cSEric Fiselier _ALIGNAS_TYPE(_ArrayInStructT) _CharType __elems_[sizeof(_ArrayInStructT)]; 25959cdf90aSEric Fiselier 2607265ff92SLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2617265ff92SLouis Dionne value_type* data() _NOEXCEPT {return nullptr;} 2627265ff92SLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2637265ff92SLouis Dionne const value_type* data() const _NOEXCEPT {return nullptr;} 26477b9abfcSLouis Dionne 26559cdf90aSEric Fiselier // No explicit construct/copy/destroy for aggregate type 26677b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 26777b9abfcSLouis Dionne void fill(const value_type&) { 26859cdf90aSEric Fiselier static_assert(!is_const<_Tp>::value, 26959cdf90aSEric Fiselier "cannot fill zero-sized array of type 'const T'"); 27059cdf90aSEric Fiselier } 27159cdf90aSEric Fiselier 27277b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 27359cdf90aSEric Fiselier void swap(array&) _NOEXCEPT { 27459cdf90aSEric Fiselier static_assert(!is_const<_Tp>::value, 27559cdf90aSEric Fiselier "cannot swap zero-sized array of type 'const T'"); 27659cdf90aSEric Fiselier } 27759cdf90aSEric Fiselier 27859cdf90aSEric Fiselier // iterators: 27977b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 28059cdf90aSEric Fiselier iterator begin() _NOEXCEPT {return iterator(data());} 28177b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 28259cdf90aSEric Fiselier const_iterator begin() const _NOEXCEPT {return const_iterator(data());} 28377b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 28459cdf90aSEric Fiselier iterator end() _NOEXCEPT {return iterator(data());} 28577b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 28659cdf90aSEric Fiselier const_iterator end() const _NOEXCEPT {return const_iterator(data());} 28759cdf90aSEric Fiselier 28877b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 28959cdf90aSEric Fiselier reverse_iterator rbegin() _NOEXCEPT {return reverse_iterator(end());} 29077b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 29159cdf90aSEric Fiselier const_reverse_iterator rbegin() const _NOEXCEPT {return const_reverse_iterator(end());} 29277b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 29359cdf90aSEric Fiselier reverse_iterator rend() _NOEXCEPT {return reverse_iterator(begin());} 29477b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 29559cdf90aSEric Fiselier const_reverse_iterator rend() const _NOEXCEPT {return const_reverse_iterator(begin());} 29659cdf90aSEric Fiselier 29777b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 29859cdf90aSEric Fiselier const_iterator cbegin() const _NOEXCEPT {return begin();} 29977b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 30059cdf90aSEric Fiselier const_iterator cend() const _NOEXCEPT {return end();} 30177b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 30259cdf90aSEric Fiselier const_reverse_iterator crbegin() const _NOEXCEPT {return rbegin();} 30377b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 30459cdf90aSEric Fiselier const_reverse_iterator crend() const _NOEXCEPT {return rend();} 30559cdf90aSEric Fiselier 30659cdf90aSEric Fiselier // capacity: 30759cdf90aSEric Fiselier _LIBCPP_INLINE_VISIBILITY 30859cdf90aSEric Fiselier _LIBCPP_CONSTEXPR size_type size() const _NOEXCEPT {return 0; } 30959cdf90aSEric Fiselier _LIBCPP_INLINE_VISIBILITY 31059cdf90aSEric Fiselier _LIBCPP_CONSTEXPR size_type max_size() const _NOEXCEPT {return 0;} 31159cdf90aSEric Fiselier _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_INLINE_VISIBILITY 31259cdf90aSEric Fiselier _LIBCPP_CONSTEXPR bool empty() const _NOEXCEPT {return true;} 31359cdf90aSEric Fiselier 31459cdf90aSEric Fiselier // element access: 31577b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 3165f6a5ac1SMarshall Clow reference operator[](size_type) _NOEXCEPT { 31759cdf90aSEric Fiselier _LIBCPP_ASSERT(false, "cannot call array<T, 0>::operator[] on a zero-sized array"); 3182a8f9a5eSNikolas Klauser __libcpp_unreachable(); 31959cdf90aSEric Fiselier } 32059cdf90aSEric Fiselier 32159cdf90aSEric Fiselier _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 3225f6a5ac1SMarshall Clow const_reference operator[](size_type) const _NOEXCEPT { 32359cdf90aSEric Fiselier _LIBCPP_ASSERT(false, "cannot call array<T, 0>::operator[] on a zero-sized array"); 3242a8f9a5eSNikolas Klauser __libcpp_unreachable(); 32559cdf90aSEric Fiselier } 32659cdf90aSEric Fiselier 32777b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 32859cdf90aSEric Fiselier reference at(size_type) { 32959cdf90aSEric Fiselier __throw_out_of_range("array<T, 0>::at"); 3302a8f9a5eSNikolas Klauser __libcpp_unreachable(); 33159cdf90aSEric Fiselier } 33259cdf90aSEric Fiselier 33377b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 33459cdf90aSEric Fiselier const_reference at(size_type) const { 33559cdf90aSEric Fiselier __throw_out_of_range("array<T, 0>::at"); 3362a8f9a5eSNikolas Klauser __libcpp_unreachable(); 33759cdf90aSEric Fiselier } 33859cdf90aSEric Fiselier 33977b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 3409ea0e473SMarshall Clow reference front() _NOEXCEPT { 34159cdf90aSEric Fiselier _LIBCPP_ASSERT(false, "cannot call array<T, 0>::front() on a zero-sized array"); 3422a8f9a5eSNikolas Klauser __libcpp_unreachable(); 34359cdf90aSEric Fiselier } 34459cdf90aSEric Fiselier 34577b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 3469ea0e473SMarshall Clow const_reference front() const _NOEXCEPT { 34759cdf90aSEric Fiselier _LIBCPP_ASSERT(false, "cannot call array<T, 0>::front() on a zero-sized array"); 3482a8f9a5eSNikolas Klauser __libcpp_unreachable(); 34959cdf90aSEric Fiselier } 35059cdf90aSEric Fiselier 35177b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 3529ea0e473SMarshall Clow reference back() _NOEXCEPT { 35359cdf90aSEric Fiselier _LIBCPP_ASSERT(false, "cannot call array<T, 0>::back() on a zero-sized array"); 3542a8f9a5eSNikolas Klauser __libcpp_unreachable(); 35559cdf90aSEric Fiselier } 35659cdf90aSEric Fiselier 35777b9abfcSLouis Dionne _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 3589ea0e473SMarshall Clow const_reference back() const _NOEXCEPT { 35959cdf90aSEric Fiselier _LIBCPP_ASSERT(false, "cannot call array<T, 0>::back() on a zero-sized array"); 3602a8f9a5eSNikolas Klauser __libcpp_unreachable(); 36159cdf90aSEric Fiselier } 36259cdf90aSEric Fiselier}; 36359cdf90aSEric Fiselier 36459cdf90aSEric Fiselier 3652a8f9a5eSNikolas Klauser#if _LIBCPP_STD_VER > 14 3660ca8c089SMarshall Clowtemplate<class _Tp, class... _Args, 3674e0ea2cfSLouis Dionne class = enable_if_t<__all<_IsSame<_Tp, _Args>::value...>::value> 3680ca8c089SMarshall Clow > 3690ca8c089SMarshall Clowarray(_Tp, _Args...) 3700ca8c089SMarshall Clow -> array<_Tp, 1 + sizeof...(_Args)>; 3710ca8c089SMarshall Clow#endif 3720ca8c089SMarshall Clow 3733e519524SHoward Hinnanttemplate <class _Tp, size_t _Size> 3743af48ef7SHoward Hinnantinline _LIBCPP_INLINE_VISIBILITY 37507d8ac0aSMarshall Clow_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 3763e519524SHoward Hinnantoperator==(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 3773e519524SHoward Hinnant{ 37859cdf90aSEric Fiselier return _VSTD::equal(__x.begin(), __x.end(), __y.begin()); 3793e519524SHoward Hinnant} 3803e519524SHoward Hinnant 3813e519524SHoward Hinnanttemplate <class _Tp, size_t _Size> 3823af48ef7SHoward Hinnantinline _LIBCPP_INLINE_VISIBILITY 38307d8ac0aSMarshall Clow_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 3843e519524SHoward Hinnantoperator!=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 3853e519524SHoward Hinnant{ 3863e519524SHoward Hinnant return !(__x == __y); 3873e519524SHoward Hinnant} 3883e519524SHoward Hinnant 3893e519524SHoward Hinnanttemplate <class _Tp, size_t _Size> 3903af48ef7SHoward Hinnantinline _LIBCPP_INLINE_VISIBILITY 39107d8ac0aSMarshall Clow_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 3923e519524SHoward Hinnantoperator<(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 3933e519524SHoward Hinnant{ 39459cdf90aSEric Fiselier return _VSTD::lexicographical_compare(__x.begin(), __x.end(), 39559cdf90aSEric Fiselier __y.begin(), __y.end()); 3963e519524SHoward Hinnant} 3973e519524SHoward Hinnant 3983e519524SHoward Hinnanttemplate <class _Tp, size_t _Size> 3993af48ef7SHoward Hinnantinline _LIBCPP_INLINE_VISIBILITY 40007d8ac0aSMarshall Clow_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 4013e519524SHoward Hinnantoperator>(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 4023e519524SHoward Hinnant{ 4033e519524SHoward Hinnant return __y < __x; 4043e519524SHoward Hinnant} 4053e519524SHoward Hinnant 4063e519524SHoward Hinnanttemplate <class _Tp, size_t _Size> 4073af48ef7SHoward Hinnantinline _LIBCPP_INLINE_VISIBILITY 40807d8ac0aSMarshall Clow_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 4093e519524SHoward Hinnantoperator<=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 4103e519524SHoward Hinnant{ 4113e519524SHoward Hinnant return !(__y < __x); 4123e519524SHoward Hinnant} 4133e519524SHoward Hinnant 4143e519524SHoward Hinnanttemplate <class _Tp, size_t _Size> 4153af48ef7SHoward Hinnantinline _LIBCPP_INLINE_VISIBILITY 41607d8ac0aSMarshall Clow_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 4173e519524SHoward Hinnantoperator>=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 4183e519524SHoward Hinnant{ 4193e519524SHoward Hinnant return !(__x < __y); 4203e519524SHoward Hinnant} 4213e519524SHoward Hinnant 4223e519524SHoward Hinnanttemplate <class _Tp, size_t _Size> 42377b9abfcSLouis Dionneinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 424bc95cf0dSHoward Hinnanttypename enable_if 425bc95cf0dSHoward Hinnant< 426f07dd8d0SEric Fiselier _Size == 0 || 427bc95cf0dSHoward Hinnant __is_swappable<_Tp>::value, 4283e519524SHoward Hinnant void 429bc95cf0dSHoward Hinnant>::type 430ee66eb13SMarshall Clowswap(array<_Tp, _Size>& __x, array<_Tp, _Size>& __y) 431f07dd8d0SEric Fiselier _NOEXCEPT_(noexcept(__x.swap(__y))) 4323e519524SHoward Hinnant{ 4333e519524SHoward Hinnant __x.swap(__y); 4343e519524SHoward Hinnant} 4353e519524SHoward Hinnant 4363e519524SHoward Hinnanttemplate <class _Tp, size_t _Size> 437e4957601SMarshall Clowstruct _LIBCPP_TEMPLATE_VIS tuple_size<array<_Tp, _Size> > 438f5ab703fSHoward Hinnant : public integral_constant<size_t, _Size> {}; 4393e519524SHoward Hinnant 4403e519524SHoward Hinnanttemplate <size_t _Ip, class _Tp, size_t _Size> 4412b0c7abbSLouis Dionnestruct _LIBCPP_TEMPLATE_VIS tuple_element<_Ip, array<_Tp, _Size> > 4423e519524SHoward Hinnant{ 4436db379a2SMarshall Clow static_assert(_Ip < _Size, "Index out of bounds in std::tuple_element<> (std::array)"); 4443e519524SHoward Hinnant typedef _Tp type; 4453e519524SHoward Hinnant}; 4463e519524SHoward Hinnant 4473e519524SHoward Hinnanttemplate <size_t _Ip, class _Tp, size_t _Size> 4483af48ef7SHoward Hinnantinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 4493e519524SHoward Hinnant_Tp& 4508f0cd597SHoward Hinnantget(array<_Tp, _Size>& __a) _NOEXCEPT 4513e519524SHoward Hinnant{ 45236a60721SMarshall Clow static_assert(_Ip < _Size, "Index out of bounds in std::get<> (std::array)"); 4538bf1f08aSMarshall Clow return __a.__elems_[_Ip]; 4543e519524SHoward Hinnant} 4553e519524SHoward Hinnant 4563e519524SHoward Hinnanttemplate <size_t _Ip, class _Tp, size_t _Size> 4573af48ef7SHoward Hinnantinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 4583e519524SHoward Hinnantconst _Tp& 4598f0cd597SHoward Hinnantget(const array<_Tp, _Size>& __a) _NOEXCEPT 4603e519524SHoward Hinnant{ 46136a60721SMarshall Clow static_assert(_Ip < _Size, "Index out of bounds in std::get<> (const std::array)"); 4628bf1f08aSMarshall Clow return __a.__elems_[_Ip]; 4633e519524SHoward Hinnant} 4643e519524SHoward Hinnant 465601afb30SHoward Hinnanttemplate <size_t _Ip, class _Tp, size_t _Size> 4663af48ef7SHoward Hinnantinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 467601afb30SHoward Hinnant_Tp&& 4688f0cd597SHoward Hinnantget(array<_Tp, _Size>&& __a) _NOEXCEPT 469601afb30SHoward Hinnant{ 47036a60721SMarshall Clow static_assert(_Ip < _Size, "Index out of bounds in std::get<> (std::array &&)"); 4718bf1f08aSMarshall Clow return _VSTD::move(__a.__elems_[_Ip]); 472601afb30SHoward Hinnant} 473601afb30SHoward Hinnant 474545b8861SEric Fiseliertemplate <size_t _Ip, class _Tp, size_t _Size> 475545b8861SEric Fiselierinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 476545b8861SEric Fiselierconst _Tp&& 477545b8861SEric Fiselierget(const array<_Tp, _Size>&& __a) _NOEXCEPT 478545b8861SEric Fiselier{ 479545b8861SEric Fiselier static_assert(_Ip < _Size, "Index out of bounds in std::get<> (const std::array &&)"); 480545b8861SEric Fiselier return _VSTD::move(__a.__elems_[_Ip]); 481545b8861SEric Fiselier} 482545b8861SEric Fiselier 483e93e58c6SMarek Kurdej#if _LIBCPP_STD_VER > 17 484e93e58c6SMarek Kurdej 485e93e58c6SMarek Kurdejtemplate <typename _Tp, size_t _Size, size_t... _Index> 486e93e58c6SMarek Kurdej_LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size> 487e93e58c6SMarek Kurdej__to_array_lvalue_impl(_Tp (&__arr)[_Size], index_sequence<_Index...>) { 488e93e58c6SMarek Kurdej return {{__arr[_Index]...}}; 489e93e58c6SMarek Kurdej} 490e93e58c6SMarek Kurdej 491e93e58c6SMarek Kurdejtemplate <typename _Tp, size_t _Size, size_t... _Index> 492e93e58c6SMarek Kurdej_LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size> 493e93e58c6SMarek Kurdej__to_array_rvalue_impl(_Tp(&&__arr)[_Size], index_sequence<_Index...>) { 494e93e58c6SMarek Kurdej return {{_VSTD::move(__arr[_Index])...}}; 495e93e58c6SMarek Kurdej} 496e93e58c6SMarek Kurdej 497e93e58c6SMarek Kurdejtemplate <typename _Tp, size_t _Size> 498e93e58c6SMarek Kurdej_LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size> 499e93e58c6SMarek Kurdejto_array(_Tp (&__arr)[_Size]) noexcept(is_nothrow_constructible_v<_Tp, _Tp&>) { 500e93e58c6SMarek Kurdej static_assert( 501e93e58c6SMarek Kurdej !is_array_v<_Tp>, 502e93e58c6SMarek Kurdej "[array.creation]/1: to_array does not accept multidimensional arrays."); 503e93e58c6SMarek Kurdej static_assert( 504e93e58c6SMarek Kurdej is_constructible_v<_Tp, _Tp&>, 505e93e58c6SMarek Kurdej "[array.creation]/1: to_array requires copy constructible elements."); 506781c476cSArthur O'Dwyer return _VSTD::__to_array_lvalue_impl(__arr, make_index_sequence<_Size>()); 507e93e58c6SMarek Kurdej} 508e93e58c6SMarek Kurdej 509e93e58c6SMarek Kurdejtemplate <typename _Tp, size_t _Size> 510e93e58c6SMarek Kurdej_LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size> 511e93e58c6SMarek Kurdejto_array(_Tp(&&__arr)[_Size]) noexcept(is_nothrow_move_constructible_v<_Tp>) { 512e93e58c6SMarek Kurdej static_assert( 513e93e58c6SMarek Kurdej !is_array_v<_Tp>, 514e93e58c6SMarek Kurdej "[array.creation]/4: to_array does not accept multidimensional arrays."); 515e93e58c6SMarek Kurdej static_assert( 516e93e58c6SMarek Kurdej is_move_constructible_v<_Tp>, 517e93e58c6SMarek Kurdej "[array.creation]/4: to_array requires move constructible elements."); 518781c476cSArthur O'Dwyer return _VSTD::__to_array_rvalue_impl(_VSTD::move(__arr), 519e93e58c6SMarek Kurdej make_index_sequence<_Size>()); 520e93e58c6SMarek Kurdej} 521e93e58c6SMarek Kurdej 522e93e58c6SMarek Kurdej#endif // _LIBCPP_STD_VER > 17 523e93e58c6SMarek Kurdej 5243e519524SHoward Hinnant_LIBCPP_END_NAMESPACE_STD 5253e519524SHoward Hinnant 5263e519524SHoward Hinnant#endif // _LIBCPP_ARRAY 527