10b57cec5SDimitry Andric// -*- C++ -*- 20b57cec5SDimitry Andric//===---------------------------- array -----------------------------------===// 30b57cec5SDimitry Andric// 40b57cec5SDimitry Andric// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 50b57cec5SDimitry Andric// See https://llvm.org/LICENSE.txt for license information. 60b57cec5SDimitry Andric// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 70b57cec5SDimitry Andric// 80b57cec5SDimitry Andric//===----------------------------------------------------------------------===// 90b57cec5SDimitry Andric 100b57cec5SDimitry Andric#ifndef _LIBCPP_ARRAY 110b57cec5SDimitry Andric#define _LIBCPP_ARRAY 120b57cec5SDimitry Andric 130b57cec5SDimitry Andric/* 140b57cec5SDimitry Andric array synopsis 150b57cec5SDimitry Andric 160b57cec5SDimitry Andricnamespace std 170b57cec5SDimitry Andric{ 180b57cec5SDimitry Andrictemplate <class T, size_t N > 190b57cec5SDimitry Andricstruct array 200b57cec5SDimitry Andric{ 210b57cec5SDimitry Andric // types: 220b57cec5SDimitry Andric typedef T & reference; 230b57cec5SDimitry Andric typedef const T & const_reference; 240b57cec5SDimitry Andric typedef implementation defined iterator; 250b57cec5SDimitry Andric typedef implementation defined const_iterator; 260b57cec5SDimitry Andric typedef size_t size_type; 270b57cec5SDimitry Andric typedef ptrdiff_t difference_type; 280b57cec5SDimitry Andric typedef T value_type; 290b57cec5SDimitry Andric typedef T* pointer; 300b57cec5SDimitry Andric typedef const T* const_pointer; 310b57cec5SDimitry Andric typedef std::reverse_iterator<iterator> reverse_iterator; 320b57cec5SDimitry Andric typedef std::reverse_iterator<const_iterator> const_reverse_iterator; 330b57cec5SDimitry Andric 340b57cec5SDimitry Andric // No explicit construct/copy/destroy for aggregate type 355ffd83dbSDimitry Andric void fill(const T& u); // constexpr in C++20 365ffd83dbSDimitry Andric void swap(array& a) noexcept(is_nothrow_swappable_v<T>); // constexpr in C++20 370b57cec5SDimitry Andric 380b57cec5SDimitry Andric // iterators: 395ffd83dbSDimitry Andric iterator begin() noexcept; // constexpr in C++17 405ffd83dbSDimitry Andric const_iterator begin() const noexcept; // constexpr in C++17 415ffd83dbSDimitry Andric iterator end() noexcept; // constexpr in C++17 425ffd83dbSDimitry Andric const_iterator end() const noexcept; // constexpr in C++17 430b57cec5SDimitry Andric 445ffd83dbSDimitry Andric reverse_iterator rbegin() noexcept; // constexpr in C++17 455ffd83dbSDimitry Andric const_reverse_iterator rbegin() const noexcept; // constexpr in C++17 465ffd83dbSDimitry Andric reverse_iterator rend() noexcept; // constexpr in C++17 475ffd83dbSDimitry Andric const_reverse_iterator rend() const noexcept; // constexpr in C++17 480b57cec5SDimitry Andric 495ffd83dbSDimitry Andric const_iterator cbegin() const noexcept; // constexpr in C++17 505ffd83dbSDimitry Andric const_iterator cend() const noexcept; // constexpr in C++17 515ffd83dbSDimitry Andric const_reverse_iterator crbegin() const noexcept; // constexpr in C++17 525ffd83dbSDimitry Andric const_reverse_iterator crend() const noexcept; // constexpr in C++17 530b57cec5SDimitry Andric 540b57cec5SDimitry Andric // capacity: 550b57cec5SDimitry Andric constexpr size_type size() const noexcept; 560b57cec5SDimitry Andric constexpr size_type max_size() const noexcept; 570b57cec5SDimitry Andric constexpr bool empty() const noexcept; 580b57cec5SDimitry Andric 590b57cec5SDimitry Andric // element access: 605ffd83dbSDimitry Andric reference operator[](size_type n); // constexpr in C++17 610b57cec5SDimitry Andric const_reference operator[](size_type n) const; // constexpr in C++14 625ffd83dbSDimitry Andric reference at(size_type n); // constexpr in C++17 630b57cec5SDimitry Andric const_reference at(size_type n) const; // constexpr in C++14 640b57cec5SDimitry Andric 655ffd83dbSDimitry Andric reference front(); // constexpr in C++17 660b57cec5SDimitry Andric const_reference front() const; // constexpr in C++14 675ffd83dbSDimitry Andric reference back(); // constexpr in C++17 680b57cec5SDimitry Andric const_reference back() const; // constexpr in C++14 690b57cec5SDimitry Andric 705ffd83dbSDimitry Andric T* data() noexcept; // constexpr in C++17 715ffd83dbSDimitry Andric const T* data() const noexcept; // constexpr in C++17 720b57cec5SDimitry Andric}; 730b57cec5SDimitry Andric 740b57cec5SDimitry Andrictemplate <class T, class... U> 755ffd83dbSDimitry Andric array(T, U...) -> array<T, 1 + sizeof...(U)>; // C++17 760b57cec5SDimitry Andric 770b57cec5SDimitry Andrictemplate <class T, size_t N> 785ffd83dbSDimitry Andric bool operator==(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 790b57cec5SDimitry Andrictemplate <class T, size_t N> 805ffd83dbSDimitry Andric bool operator!=(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 810b57cec5SDimitry Andrictemplate <class T, size_t N> 825ffd83dbSDimitry Andric bool operator<(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 830b57cec5SDimitry Andrictemplate <class T, size_t N> 845ffd83dbSDimitry Andric bool operator>(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 850b57cec5SDimitry Andrictemplate <class T, size_t N> 865ffd83dbSDimitry Andric bool operator<=(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 870b57cec5SDimitry Andrictemplate <class T, size_t N> 885ffd83dbSDimitry Andric bool operator>=(const array<T,N>& x, const array<T,N>& y); // constexpr in C++20 890b57cec5SDimitry Andric 900b57cec5SDimitry Andrictemplate <class T, size_t N > 915ffd83dbSDimitry Andric void swap(array<T,N>& x, array<T,N>& y) noexcept(noexcept(x.swap(y))); // constexpr in C++20 925ffd83dbSDimitry Andric 935ffd83dbSDimitry Andrictemplate <class T, size_t N> 945ffd83dbSDimitry Andric constexpr array<remove_cv_t<T>, N> to_array(T (&a)[N]); // C++20 955ffd83dbSDimitry Andrictemplate <class T, size_t N> 965ffd83dbSDimitry Andric constexpr array<remove_cv_t<T>, N> to_array(T (&&a)[N]); // C++20 970b57cec5SDimitry Andric 980b57cec5SDimitry Andrictemplate <class T> struct tuple_size; 990b57cec5SDimitry Andrictemplate <size_t I, class T> struct tuple_element; 1000b57cec5SDimitry Andrictemplate <class T, size_t N> struct tuple_size<array<T, N>>; 1010b57cec5SDimitry Andrictemplate <size_t I, class T, size_t N> struct tuple_element<I, array<T, N>>; 1020b57cec5SDimitry Andrictemplate <size_t I, class T, size_t N> T& get(array<T, N>&) noexcept; // constexpr in C++14 1030b57cec5SDimitry Andrictemplate <size_t I, class T, size_t N> const T& get(const array<T, N>&) noexcept; // constexpr in C++14 1040b57cec5SDimitry Andrictemplate <size_t I, class T, size_t N> T&& get(array<T, N>&&) noexcept; // constexpr in C++14 1050b57cec5SDimitry Andrictemplate <size_t I, class T, size_t N> const T&& get(const array<T, N>&&) noexcept; // constexpr in C++14 1060b57cec5SDimitry Andric 1070b57cec5SDimitry Andric} // std 1080b57cec5SDimitry Andric 1090b57cec5SDimitry Andric*/ 1100b57cec5SDimitry Andric 1110b57cec5SDimitry Andric#include <__config> 112*fe6060f1SDimitry Andric#include <__debug> 1130b57cec5SDimitry Andric#include <__tuple> 114*fe6060f1SDimitry Andric#include <algorithm> 115*fe6060f1SDimitry Andric#include <cstdlib> // for _LIBCPP_UNREACHABLE 116*fe6060f1SDimitry Andric#include <iterator> 117*fe6060f1SDimitry Andric#include <stdexcept> 1180b57cec5SDimitry Andric#include <type_traits> 1190b57cec5SDimitry Andric#include <utility> 1200b57cec5SDimitry Andric#include <version> 1210b57cec5SDimitry Andric 1220b57cec5SDimitry Andric#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER) 1230b57cec5SDimitry Andric#pragma GCC system_header 1240b57cec5SDimitry Andric#endif 1250b57cec5SDimitry Andric 1260b57cec5SDimitry Andric_LIBCPP_BEGIN_NAMESPACE_STD 1270b57cec5SDimitry Andric 1280b57cec5SDimitry Andrictemplate <class _Tp, size_t _Size> 1290b57cec5SDimitry Andricstruct _LIBCPP_TEMPLATE_VIS array 1300b57cec5SDimitry Andric{ 1310b57cec5SDimitry Andric // types: 1320b57cec5SDimitry Andric typedef array __self; 1330b57cec5SDimitry Andric typedef _Tp value_type; 1340b57cec5SDimitry Andric typedef value_type& reference; 1350b57cec5SDimitry Andric typedef const value_type& const_reference; 1360b57cec5SDimitry Andric typedef value_type* iterator; 1370b57cec5SDimitry Andric typedef const value_type* const_iterator; 1380b57cec5SDimitry Andric typedef value_type* pointer; 1390b57cec5SDimitry Andric typedef const value_type* const_pointer; 1400b57cec5SDimitry Andric typedef size_t size_type; 1410b57cec5SDimitry Andric typedef ptrdiff_t difference_type; 142e8d8bef9SDimitry Andric typedef _VSTD::reverse_iterator<iterator> reverse_iterator; 143e8d8bef9SDimitry Andric typedef _VSTD::reverse_iterator<const_iterator> const_reverse_iterator; 1440b57cec5SDimitry Andric 1450b57cec5SDimitry Andric _Tp __elems_[_Size]; 1460b57cec5SDimitry Andric 1470b57cec5SDimitry Andric // No explicit construct/copy/destroy for aggregate type 1485ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 1495ffd83dbSDimitry Andric void fill(const value_type& __u) { 1505ffd83dbSDimitry Andric _VSTD::fill_n(data(), _Size, __u); 1510b57cec5SDimitry Andric } 1520b57cec5SDimitry Andric 1535ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 1540b57cec5SDimitry Andric void swap(array& __a) _NOEXCEPT_(__is_nothrow_swappable<_Tp>::value) { 155e8d8bef9SDimitry Andric _VSTD::swap_ranges(data(), data() + _Size, __a.data()); 1560b57cec5SDimitry Andric } 1570b57cec5SDimitry Andric 1580b57cec5SDimitry Andric // iterators: 1590b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1600b57cec5SDimitry Andric iterator begin() _NOEXCEPT {return iterator(data());} 1610b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1620b57cec5SDimitry Andric const_iterator begin() const _NOEXCEPT {return const_iterator(data());} 1630b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1640b57cec5SDimitry Andric iterator end() _NOEXCEPT {return iterator(data() + _Size);} 1650b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1660b57cec5SDimitry Andric const_iterator end() const _NOEXCEPT {return const_iterator(data() + _Size);} 1670b57cec5SDimitry Andric 1680b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1690b57cec5SDimitry Andric reverse_iterator rbegin() _NOEXCEPT {return reverse_iterator(end());} 1700b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1710b57cec5SDimitry Andric const_reverse_iterator rbegin() const _NOEXCEPT {return const_reverse_iterator(end());} 1720b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1730b57cec5SDimitry Andric reverse_iterator rend() _NOEXCEPT {return reverse_iterator(begin());} 1740b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1750b57cec5SDimitry Andric const_reverse_iterator rend() const _NOEXCEPT {return const_reverse_iterator(begin());} 1760b57cec5SDimitry Andric 1770b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1780b57cec5SDimitry Andric const_iterator cbegin() const _NOEXCEPT {return begin();} 1790b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1800b57cec5SDimitry Andric const_iterator cend() const _NOEXCEPT {return end();} 1810b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1820b57cec5SDimitry Andric const_reverse_iterator crbegin() const _NOEXCEPT {return rbegin();} 1830b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1840b57cec5SDimitry Andric const_reverse_iterator crend() const _NOEXCEPT {return rend();} 1850b57cec5SDimitry Andric 1860b57cec5SDimitry Andric // capacity: 1870b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY 1880b57cec5SDimitry Andric _LIBCPP_CONSTEXPR size_type size() const _NOEXCEPT {return _Size;} 1890b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY 1900b57cec5SDimitry Andric _LIBCPP_CONSTEXPR size_type max_size() const _NOEXCEPT {return _Size;} 1910b57cec5SDimitry Andric _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_INLINE_VISIBILITY 1925ffd83dbSDimitry Andric _LIBCPP_CONSTEXPR bool empty() const _NOEXCEPT {return _Size == 0;} 1930b57cec5SDimitry Andric 1940b57cec5SDimitry Andric // element access: 1950b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 1965ffd83dbSDimitry Andric reference operator[](size_type __n) _NOEXCEPT { 1975ffd83dbSDimitry Andric _LIBCPP_ASSERT(__n < _Size, "out-of-bounds access in std::array<T, N>"); 1985ffd83dbSDimitry Andric return __elems_[__n]; 1995ffd83dbSDimitry Andric } 2000b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 2015ffd83dbSDimitry Andric const_reference operator[](size_type __n) const _NOEXCEPT { 2025ffd83dbSDimitry Andric _LIBCPP_ASSERT(__n < _Size, "out-of-bounds access in std::array<T, N>"); 2035ffd83dbSDimitry Andric return __elems_[__n]; 2045ffd83dbSDimitry Andric } 2050b57cec5SDimitry Andric 2065ffd83dbSDimitry Andric _LIBCPP_CONSTEXPR_AFTER_CXX14 reference at(size_type __n) 2075ffd83dbSDimitry Andric { 2085ffd83dbSDimitry Andric if (__n >= _Size) 2095ffd83dbSDimitry Andric __throw_out_of_range("array::at"); 2105ffd83dbSDimitry Andric return __elems_[__n]; 2115ffd83dbSDimitry Andric } 2120b57cec5SDimitry Andric 2135ffd83dbSDimitry Andric _LIBCPP_CONSTEXPR_AFTER_CXX11 const_reference at(size_type __n) const 2145ffd83dbSDimitry Andric { 2155ffd83dbSDimitry Andric if (__n >= _Size) 2165ffd83dbSDimitry Andric __throw_out_of_range("array::at"); 2175ffd83dbSDimitry Andric return __elems_[__n]; 2185ffd83dbSDimitry Andric } 2195ffd83dbSDimitry Andric 2205ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 reference front() _NOEXCEPT {return (*this)[0];} 2215ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 const_reference front() const _NOEXCEPT {return (*this)[0];} 2225ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 reference back() _NOEXCEPT {return (*this)[_Size - 1];} 2235ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 const_reference back() const _NOEXCEPT {return (*this)[_Size - 1];} 2240b57cec5SDimitry Andric 2250b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2260b57cec5SDimitry Andric value_type* data() _NOEXCEPT {return __elems_;} 2270b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2280b57cec5SDimitry Andric const value_type* data() const _NOEXCEPT {return __elems_;} 2290b57cec5SDimitry Andric}; 2300b57cec5SDimitry Andric 2310b57cec5SDimitry Andrictemplate <class _Tp> 2320b57cec5SDimitry Andricstruct _LIBCPP_TEMPLATE_VIS array<_Tp, 0> 2330b57cec5SDimitry Andric{ 2340b57cec5SDimitry Andric // types: 2350b57cec5SDimitry Andric typedef array __self; 2360b57cec5SDimitry Andric typedef _Tp value_type; 2370b57cec5SDimitry Andric typedef value_type& reference; 2380b57cec5SDimitry Andric typedef const value_type& const_reference; 2390b57cec5SDimitry Andric typedef value_type* iterator; 2400b57cec5SDimitry Andric typedef const value_type* const_iterator; 2410b57cec5SDimitry Andric typedef value_type* pointer; 2420b57cec5SDimitry Andric typedef const value_type* const_pointer; 2430b57cec5SDimitry Andric typedef size_t size_type; 2440b57cec5SDimitry Andric typedef ptrdiff_t difference_type; 245e8d8bef9SDimitry Andric typedef _VSTD::reverse_iterator<iterator> reverse_iterator; 246e8d8bef9SDimitry Andric typedef _VSTD::reverse_iterator<const_iterator> const_reverse_iterator; 2470b57cec5SDimitry Andric 2480b57cec5SDimitry Andric typedef typename conditional<is_const<_Tp>::value, const char, 2490b57cec5SDimitry Andric char>::type _CharType; 2500b57cec5SDimitry Andric 2510b57cec5SDimitry Andric struct _ArrayInStructT { _Tp __data_[1]; }; 2520b57cec5SDimitry Andric _ALIGNAS_TYPE(_ArrayInStructT) _CharType __elems_[sizeof(_ArrayInStructT)]; 2530b57cec5SDimitry Andric 2545ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2555ffd83dbSDimitry Andric value_type* data() _NOEXCEPT {return nullptr;} 2565ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2575ffd83dbSDimitry Andric const value_type* data() const _NOEXCEPT {return nullptr;} 2585ffd83dbSDimitry Andric 2590b57cec5SDimitry Andric // No explicit construct/copy/destroy for aggregate type 2605ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 2615ffd83dbSDimitry Andric void fill(const value_type&) { 2620b57cec5SDimitry Andric static_assert(!is_const<_Tp>::value, 2630b57cec5SDimitry Andric "cannot fill zero-sized array of type 'const T'"); 2640b57cec5SDimitry Andric } 2650b57cec5SDimitry Andric 2665ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 2670b57cec5SDimitry Andric void swap(array&) _NOEXCEPT { 2680b57cec5SDimitry Andric static_assert(!is_const<_Tp>::value, 2690b57cec5SDimitry Andric "cannot swap zero-sized array of type 'const T'"); 2700b57cec5SDimitry Andric } 2710b57cec5SDimitry Andric 2720b57cec5SDimitry Andric // iterators: 2735ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2740b57cec5SDimitry Andric iterator begin() _NOEXCEPT {return iterator(data());} 2755ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2760b57cec5SDimitry Andric const_iterator begin() const _NOEXCEPT {return const_iterator(data());} 2775ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2780b57cec5SDimitry Andric iterator end() _NOEXCEPT {return iterator(data());} 2795ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2800b57cec5SDimitry Andric const_iterator end() const _NOEXCEPT {return const_iterator(data());} 2810b57cec5SDimitry Andric 2825ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2830b57cec5SDimitry Andric reverse_iterator rbegin() _NOEXCEPT {return reverse_iterator(end());} 2845ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2850b57cec5SDimitry Andric const_reverse_iterator rbegin() const _NOEXCEPT {return const_reverse_iterator(end());} 2865ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2870b57cec5SDimitry Andric reverse_iterator rend() _NOEXCEPT {return reverse_iterator(begin());} 2885ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2890b57cec5SDimitry Andric const_reverse_iterator rend() const _NOEXCEPT {return const_reverse_iterator(begin());} 2900b57cec5SDimitry Andric 2915ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2920b57cec5SDimitry Andric const_iterator cbegin() const _NOEXCEPT {return begin();} 2935ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2940b57cec5SDimitry Andric const_iterator cend() const _NOEXCEPT {return end();} 2955ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2960b57cec5SDimitry Andric const_reverse_iterator crbegin() const _NOEXCEPT {return rbegin();} 2975ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 2980b57cec5SDimitry Andric const_reverse_iterator crend() const _NOEXCEPT {return rend();} 2990b57cec5SDimitry Andric 3000b57cec5SDimitry Andric // capacity: 3010b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY 3020b57cec5SDimitry Andric _LIBCPP_CONSTEXPR size_type size() const _NOEXCEPT {return 0; } 3030b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY 3040b57cec5SDimitry Andric _LIBCPP_CONSTEXPR size_type max_size() const _NOEXCEPT {return 0;} 3050b57cec5SDimitry Andric _LIBCPP_NODISCARD_AFTER_CXX17 _LIBCPP_INLINE_VISIBILITY 3060b57cec5SDimitry Andric _LIBCPP_CONSTEXPR bool empty() const _NOEXCEPT {return true;} 3070b57cec5SDimitry Andric 3080b57cec5SDimitry Andric // element access: 3095ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 3100b57cec5SDimitry Andric reference operator[](size_type) _NOEXCEPT { 3110b57cec5SDimitry Andric _LIBCPP_ASSERT(false, "cannot call array<T, 0>::operator[] on a zero-sized array"); 3120b57cec5SDimitry Andric _LIBCPP_UNREACHABLE(); 3130b57cec5SDimitry Andric } 3140b57cec5SDimitry Andric 3150b57cec5SDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 3160b57cec5SDimitry Andric const_reference operator[](size_type) const _NOEXCEPT { 3170b57cec5SDimitry Andric _LIBCPP_ASSERT(false, "cannot call array<T, 0>::operator[] on a zero-sized array"); 3180b57cec5SDimitry Andric _LIBCPP_UNREACHABLE(); 3190b57cec5SDimitry Andric } 3200b57cec5SDimitry Andric 3215ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 3220b57cec5SDimitry Andric reference at(size_type) { 3230b57cec5SDimitry Andric __throw_out_of_range("array<T, 0>::at"); 3240b57cec5SDimitry Andric _LIBCPP_UNREACHABLE(); 3250b57cec5SDimitry Andric } 3260b57cec5SDimitry Andric 3275ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 3280b57cec5SDimitry Andric const_reference at(size_type) const { 3290b57cec5SDimitry Andric __throw_out_of_range("array<T, 0>::at"); 3300b57cec5SDimitry Andric _LIBCPP_UNREACHABLE(); 3310b57cec5SDimitry Andric } 3320b57cec5SDimitry Andric 3335ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 3340b57cec5SDimitry Andric reference front() _NOEXCEPT { 3350b57cec5SDimitry Andric _LIBCPP_ASSERT(false, "cannot call array<T, 0>::front() on a zero-sized array"); 3360b57cec5SDimitry Andric _LIBCPP_UNREACHABLE(); 3370b57cec5SDimitry Andric } 3380b57cec5SDimitry Andric 3395ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 3400b57cec5SDimitry Andric const_reference front() const _NOEXCEPT { 3410b57cec5SDimitry Andric _LIBCPP_ASSERT(false, "cannot call array<T, 0>::front() on a zero-sized array"); 3420b57cec5SDimitry Andric _LIBCPP_UNREACHABLE(); 3430b57cec5SDimitry Andric } 3440b57cec5SDimitry Andric 3455ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX14 3460b57cec5SDimitry Andric reference back() _NOEXCEPT { 3470b57cec5SDimitry Andric _LIBCPP_ASSERT(false, "cannot call array<T, 0>::back() on a zero-sized array"); 3480b57cec5SDimitry Andric _LIBCPP_UNREACHABLE(); 3490b57cec5SDimitry Andric } 3500b57cec5SDimitry Andric 3515ffd83dbSDimitry Andric _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 3520b57cec5SDimitry Andric const_reference back() const _NOEXCEPT { 3530b57cec5SDimitry Andric _LIBCPP_ASSERT(false, "cannot call array<T, 0>::back() on a zero-sized array"); 3540b57cec5SDimitry Andric _LIBCPP_UNREACHABLE(); 3550b57cec5SDimitry Andric } 3560b57cec5SDimitry Andric}; 3570b57cec5SDimitry Andric 3580b57cec5SDimitry Andric 3590b57cec5SDimitry Andric#ifndef _LIBCPP_HAS_NO_DEDUCTION_GUIDES 3600b57cec5SDimitry Andrictemplate<class _Tp, class... _Args, 36162cfcf62SDimitry Andric class = _EnableIf<__all<_IsSame<_Tp, _Args>::value...>::value> 3620b57cec5SDimitry Andric > 3630b57cec5SDimitry Andricarray(_Tp, _Args...) 3640b57cec5SDimitry Andric -> array<_Tp, 1 + sizeof...(_Args)>; 3650b57cec5SDimitry Andric#endif 3660b57cec5SDimitry Andric 3670b57cec5SDimitry Andrictemplate <class _Tp, size_t _Size> 3680b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY 3690b57cec5SDimitry Andric_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 3700b57cec5SDimitry Andricoperator==(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 3710b57cec5SDimitry Andric{ 3720b57cec5SDimitry Andric return _VSTD::equal(__x.begin(), __x.end(), __y.begin()); 3730b57cec5SDimitry Andric} 3740b57cec5SDimitry Andric 3750b57cec5SDimitry Andrictemplate <class _Tp, size_t _Size> 3760b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY 3770b57cec5SDimitry Andric_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 3780b57cec5SDimitry Andricoperator!=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 3790b57cec5SDimitry Andric{ 3800b57cec5SDimitry Andric return !(__x == __y); 3810b57cec5SDimitry Andric} 3820b57cec5SDimitry Andric 3830b57cec5SDimitry Andrictemplate <class _Tp, size_t _Size> 3840b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY 3850b57cec5SDimitry Andric_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 3860b57cec5SDimitry Andricoperator<(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 3870b57cec5SDimitry Andric{ 3880b57cec5SDimitry Andric return _VSTD::lexicographical_compare(__x.begin(), __x.end(), 3890b57cec5SDimitry Andric __y.begin(), __y.end()); 3900b57cec5SDimitry Andric} 3910b57cec5SDimitry Andric 3920b57cec5SDimitry Andrictemplate <class _Tp, size_t _Size> 3930b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY 3940b57cec5SDimitry Andric_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 3950b57cec5SDimitry Andricoperator>(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 3960b57cec5SDimitry Andric{ 3970b57cec5SDimitry Andric return __y < __x; 3980b57cec5SDimitry Andric} 3990b57cec5SDimitry Andric 4000b57cec5SDimitry Andrictemplate <class _Tp, size_t _Size> 4010b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY 4020b57cec5SDimitry Andric_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 4030b57cec5SDimitry Andricoperator<=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 4040b57cec5SDimitry Andric{ 4050b57cec5SDimitry Andric return !(__y < __x); 4060b57cec5SDimitry Andric} 4070b57cec5SDimitry Andric 4080b57cec5SDimitry Andrictemplate <class _Tp, size_t _Size> 4090b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY 4100b57cec5SDimitry Andric_LIBCPP_CONSTEXPR_AFTER_CXX17 bool 4110b57cec5SDimitry Andricoperator>=(const array<_Tp, _Size>& __x, const array<_Tp, _Size>& __y) 4120b57cec5SDimitry Andric{ 4130b57cec5SDimitry Andric return !(__x < __y); 4140b57cec5SDimitry Andric} 4150b57cec5SDimitry Andric 4160b57cec5SDimitry Andrictemplate <class _Tp, size_t _Size> 4175ffd83dbSDimitry Andricinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX17 4180b57cec5SDimitry Andrictypename enable_if 4190b57cec5SDimitry Andric< 4200b57cec5SDimitry Andric _Size == 0 || 4210b57cec5SDimitry Andric __is_swappable<_Tp>::value, 4220b57cec5SDimitry Andric void 4230b57cec5SDimitry Andric>::type 4240b57cec5SDimitry Andricswap(array<_Tp, _Size>& __x, array<_Tp, _Size>& __y) 4250b57cec5SDimitry Andric _NOEXCEPT_(noexcept(__x.swap(__y))) 4260b57cec5SDimitry Andric{ 4270b57cec5SDimitry Andric __x.swap(__y); 4280b57cec5SDimitry Andric} 4290b57cec5SDimitry Andric 4300b57cec5SDimitry Andrictemplate <class _Tp, size_t _Size> 4310b57cec5SDimitry Andricstruct _LIBCPP_TEMPLATE_VIS tuple_size<array<_Tp, _Size> > 4320b57cec5SDimitry Andric : public integral_constant<size_t, _Size> {}; 4330b57cec5SDimitry Andric 4340b57cec5SDimitry Andrictemplate <size_t _Ip, class _Tp, size_t _Size> 4350b57cec5SDimitry Andricstruct _LIBCPP_TEMPLATE_VIS tuple_element<_Ip, array<_Tp, _Size> > 4360b57cec5SDimitry Andric{ 4370b57cec5SDimitry Andric static_assert(_Ip < _Size, "Index out of bounds in std::tuple_element<> (std::array)"); 4380b57cec5SDimitry Andric typedef _Tp type; 4390b57cec5SDimitry Andric}; 4400b57cec5SDimitry Andric 4410b57cec5SDimitry Andrictemplate <size_t _Ip, class _Tp, size_t _Size> 4420b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 4430b57cec5SDimitry Andric_Tp& 4440b57cec5SDimitry Andricget(array<_Tp, _Size>& __a) _NOEXCEPT 4450b57cec5SDimitry Andric{ 4460b57cec5SDimitry Andric static_assert(_Ip < _Size, "Index out of bounds in std::get<> (std::array)"); 4470b57cec5SDimitry Andric return __a.__elems_[_Ip]; 4480b57cec5SDimitry Andric} 4490b57cec5SDimitry Andric 4500b57cec5SDimitry Andrictemplate <size_t _Ip, class _Tp, size_t _Size> 4510b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 4520b57cec5SDimitry Andricconst _Tp& 4530b57cec5SDimitry Andricget(const array<_Tp, _Size>& __a) _NOEXCEPT 4540b57cec5SDimitry Andric{ 4550b57cec5SDimitry Andric static_assert(_Ip < _Size, "Index out of bounds in std::get<> (const std::array)"); 4560b57cec5SDimitry Andric return __a.__elems_[_Ip]; 4570b57cec5SDimitry Andric} 4580b57cec5SDimitry Andric 4590b57cec5SDimitry Andrictemplate <size_t _Ip, class _Tp, size_t _Size> 4600b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 4610b57cec5SDimitry Andric_Tp&& 4620b57cec5SDimitry Andricget(array<_Tp, _Size>&& __a) _NOEXCEPT 4630b57cec5SDimitry Andric{ 4640b57cec5SDimitry Andric static_assert(_Ip < _Size, "Index out of bounds in std::get<> (std::array &&)"); 4650b57cec5SDimitry Andric return _VSTD::move(__a.__elems_[_Ip]); 4660b57cec5SDimitry Andric} 4670b57cec5SDimitry Andric 4680b57cec5SDimitry Andrictemplate <size_t _Ip, class _Tp, size_t _Size> 4690b57cec5SDimitry Andricinline _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR_AFTER_CXX11 4700b57cec5SDimitry Andricconst _Tp&& 4710b57cec5SDimitry Andricget(const array<_Tp, _Size>&& __a) _NOEXCEPT 4720b57cec5SDimitry Andric{ 4730b57cec5SDimitry Andric static_assert(_Ip < _Size, "Index out of bounds in std::get<> (const std::array &&)"); 4740b57cec5SDimitry Andric return _VSTD::move(__a.__elems_[_Ip]); 4750b57cec5SDimitry Andric} 4760b57cec5SDimitry Andric 4775ffd83dbSDimitry Andric#if _LIBCPP_STD_VER > 17 4785ffd83dbSDimitry Andric 4795ffd83dbSDimitry Andrictemplate <typename _Tp, size_t _Size, size_t... _Index> 4805ffd83dbSDimitry Andric_LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size> 4815ffd83dbSDimitry Andric__to_array_lvalue_impl(_Tp (&__arr)[_Size], index_sequence<_Index...>) { 4825ffd83dbSDimitry Andric return {{__arr[_Index]...}}; 4835ffd83dbSDimitry Andric} 4845ffd83dbSDimitry Andric 4855ffd83dbSDimitry Andrictemplate <typename _Tp, size_t _Size, size_t... _Index> 4865ffd83dbSDimitry Andric_LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size> 4875ffd83dbSDimitry Andric__to_array_rvalue_impl(_Tp(&&__arr)[_Size], index_sequence<_Index...>) { 4885ffd83dbSDimitry Andric return {{_VSTD::move(__arr[_Index])...}}; 4895ffd83dbSDimitry Andric} 4905ffd83dbSDimitry Andric 4915ffd83dbSDimitry Andrictemplate <typename _Tp, size_t _Size> 4925ffd83dbSDimitry Andric_LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size> 4935ffd83dbSDimitry Andricto_array(_Tp (&__arr)[_Size]) noexcept(is_nothrow_constructible_v<_Tp, _Tp&>) { 4945ffd83dbSDimitry Andric static_assert( 4955ffd83dbSDimitry Andric !is_array_v<_Tp>, 4965ffd83dbSDimitry Andric "[array.creation]/1: to_array does not accept multidimensional arrays."); 4975ffd83dbSDimitry Andric static_assert( 4985ffd83dbSDimitry Andric is_constructible_v<_Tp, _Tp&>, 4995ffd83dbSDimitry Andric "[array.creation]/1: to_array requires copy constructible elements."); 500e8d8bef9SDimitry Andric return _VSTD::__to_array_lvalue_impl(__arr, make_index_sequence<_Size>()); 5015ffd83dbSDimitry Andric} 5025ffd83dbSDimitry Andric 5035ffd83dbSDimitry Andrictemplate <typename _Tp, size_t _Size> 5045ffd83dbSDimitry Andric_LIBCPP_INLINE_VISIBILITY constexpr array<remove_cv_t<_Tp>, _Size> 5055ffd83dbSDimitry Andricto_array(_Tp(&&__arr)[_Size]) noexcept(is_nothrow_move_constructible_v<_Tp>) { 5065ffd83dbSDimitry Andric static_assert( 5075ffd83dbSDimitry Andric !is_array_v<_Tp>, 5085ffd83dbSDimitry Andric "[array.creation]/4: to_array does not accept multidimensional arrays."); 5095ffd83dbSDimitry Andric static_assert( 5105ffd83dbSDimitry Andric is_move_constructible_v<_Tp>, 5115ffd83dbSDimitry Andric "[array.creation]/4: to_array requires move constructible elements."); 512e8d8bef9SDimitry Andric return _VSTD::__to_array_rvalue_impl(_VSTD::move(__arr), 5135ffd83dbSDimitry Andric make_index_sequence<_Size>()); 5145ffd83dbSDimitry Andric} 5155ffd83dbSDimitry Andric 5165ffd83dbSDimitry Andric#endif // _LIBCPP_STD_VER > 17 5175ffd83dbSDimitry Andric 5180b57cec5SDimitry Andric_LIBCPP_END_NAMESPACE_STD 5190b57cec5SDimitry Andric 5200b57cec5SDimitry Andric#endif // _LIBCPP_ARRAY 521