xref: /llvm-project-15.0.7/libcxx/include/array (revision 3cd4531b)
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