/**
* This file is based on the std::array implementation of libstdc++ at
* https://gcc.gnu.org/onlinedocs/gcc-7.1.0/libstdc++/api/a01056_source.html
*
* Changes:
* - isolate, i.e. remove dependencies on internal libstdc++ stuff
* - use c++17 behavior even in c++11 or c++14
* - remove std::swappable special case because that doesn't work with MSVC
* - constexpr more things
* - add some features like prepend/tail
*
* If using std::array at runtime, feel free to either keep using std::array or
* use this one - it doesn't really matter. For compile time computations, this
* one here is preferred because std::array in C++11 misses some constexpr
* specifiers, forcing these methods to be called at runtime instead of compile
* time.
*/
// Copyright (C) 2007-2017 Free Software Foundation, Inc.
//
// This file is part of the GNU ISO C++ Library. This library is free
// software; you can redistribute it and/or modify it under the
// terms of the GNU General Public License as published by the
// Free Software Foundation; either version 3, or (at your option)
// any later version.
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
// Under Section 7 of GPL version 3, you are granted additional
// permissions described in the GCC Runtime Library Exception, version
// 3.1, as published by the Free Software Foundation.
// You should have received a copy of the GNU General Public License and
// a copy of the GCC Runtime Library Exception along with this program;
// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
// .
#pragma once
#include
#include
#include
#include
#include
namespace c10 {
namespace guts {
namespace detail {
template
struct __array_traits final {
using _Type = _Tp[_Nm];
static constexpr _Tp& _S_ref(const _Type& __t, std::size_t __n) noexcept {
return const_cast<_Tp&>(__t[__n]);
}
static constexpr _Tp* _S_ptr(const _Type& __t) noexcept {
return const_cast<_Tp*>(__t);
}
};
template
struct __array_traits<_Tp, 0> final {
struct _Type final {};
static constexpr _Tp& _S_ref(const _Type& __t, std::size_t) noexcept {
return *_S_ptr(__t);
}
static constexpr _Tp* _S_ptr(const _Type&) noexcept {
return nullptr;
}
};
[[noreturn]] inline void __throw_out_of_range(std::string msg) {
throw std::out_of_range(std::move(msg));
}
} // namespace detail
template
class array final {
public:
using value_type = _Tp;
using pointer = value_type*;
using const_pointer = const value_type*;
using reference = value_type&;
using const_reference = const value_type&;
using iterator = value_type*;
using const_iterator = const value_type*;
using size_type = std::size_t;
using difference_type = std::ptrdiff_t;
using reverse_iterator = std::reverse_iterator;
using const_reverse_iterator = std::reverse_iterator;
private:
using _AT_Type = detail::__array_traits<_Tp, _Nm>;
public: // needs to be public member for aggregate initialization
typename _AT_Type::_Type _M_elems;
public:
// No explicit construct/copy/destroy for aggregate type.
// DR 776.
constexpr void fill(const value_type& __u) {
std::fill_n(begin(), size(), __u);
}
constexpr void swap(array& __other) {
std::swap_ranges(begin(), end(), __other.begin());
}
// Iterators.
constexpr iterator begin() noexcept {
return iterator(data());
}
constexpr const_iterator begin() const noexcept {
return const_iterator(data());
}
constexpr iterator end() noexcept {
return iterator(data() + _Nm);
}
constexpr const_iterator end() const noexcept {
return const_iterator(data() + _Nm);
}
constexpr reverse_iterator rbegin() noexcept {
return reverse_iterator(end());
}
constexpr const_reverse_iterator rbegin() const noexcept {
return const_reverse_iterator(end());
}
constexpr reverse_iterator rend() noexcept {
return reverse_iterator(begin());
}
constexpr const_reverse_iterator rend() const noexcept {
return const_reverse_iterator(begin());
}
constexpr const_iterator cbegin() const noexcept {
return const_iterator(data());
}
constexpr const_iterator cend() const noexcept {
return const_iterator(data() + _Nm);
}
constexpr const_reverse_iterator crbegin() const noexcept {
return const_reverse_iterator(end());
}
constexpr const_reverse_iterator crend() const noexcept {
return const_reverse_iterator(begin());
}
// Capacity.
constexpr size_type size() const noexcept {
return _Nm;
}
constexpr size_type max_size() const noexcept {
return _Nm;
}
constexpr bool empty() const noexcept {
return size() == 0;
}
// Element access.
constexpr reference operator[](size_type __n) noexcept {
return _AT_Type::_S_ref(_M_elems, __n);
}
constexpr const_reference operator[](size_type __n) const noexcept {
return _AT_Type::_S_ref(_M_elems, __n);
}
constexpr reference at(size_type __n) {
if (__n >= _Nm) {
detail::__throw_out_of_range(
std::string() + "array::at: __n (which is " + to_string(__n) + ") " +
">= _Nm (which is " + to_string(_Nm) + ")");
}
return _AT_Type::_S_ref(_M_elems, __n);
}
constexpr const_reference at(size_type __n) const {
// Result of conditional expression must be an lvalue so use
// boolean ? lvalue : (throw-expr, lvalue)
return __n < _Nm
? _AT_Type::_S_ref(_M_elems, __n)
: (detail::__throw_out_of_range(
std::string() + "array::at: __n (which is " + to_string(__n) +
") " + ">= _Nm (which is " + to_string(_Nm) + ")"),
_AT_Type::_S_ref(_M_elems, 0));
}
constexpr reference front() noexcept {
return *begin();
}
constexpr const_reference front() const noexcept {
return _AT_Type::_S_ref(_M_elems, 0);
}
constexpr reference back() noexcept {
return _Nm ? *(end() - 1) : *end();
}
constexpr const_reference back() const noexcept {
return _Nm ? _AT_Type::_S_ref(_M_elems, _Nm - 1)
: _AT_Type::_S_ref(_M_elems, 0);
}
constexpr pointer data() noexcept {
return _AT_Type::_S_ptr(_M_elems);
}
constexpr const_pointer data() const noexcept {
return _AT_Type::_S_ptr(_M_elems);
}
};
#if defined(__cpp_deduction_guides) && __cpp_deduction_guides >= 201606
template
array(_Tp, _Up...) -> array<
std::enable_if_t<(std::is_same<_Tp, _Up>::value && ...), _Tp>,
1 + sizeof...(_Up)>;
#endif
// Array comparisons.
namespace detail {
template
constexpr inline bool array_equals_(
const array& lhs,
const array& rhs,
size_t current_index) {
return (current_index == N)
? true
: (lhs.at(current_index) == rhs.at(current_index) &&
array_equals_(lhs, rhs, current_index + 1));
}
template
constexpr inline bool array_less_(
const array& lhs,
const array& rhs,
size_t current_index) {
return (current_index == N)
? false
: (lhs.at(current_index) < rhs.at(current_index) ||
array_less_(lhs, rhs, current_index + 1));
}
} // namespace detail
template
constexpr inline bool operator==(
const array<_Tp, _Nm>& __one,
const array<_Tp, _Nm>& __two) {
return detail::array_equals_(__one, __two, 0);
}
template
constexpr inline bool operator!=(
const array<_Tp, _Nm>& __one,
const array<_Tp, _Nm>& __two) {
return !(__one == __two);
}
template
constexpr inline bool operator<(
const array<_Tp, _Nm>& __a,
const array<_Tp, _Nm>& __b) {
return detail::array_less_(__a, __b, 0);
}
template
constexpr inline bool operator>(
const array<_Tp, _Nm>& __one,
const array<_Tp, _Nm>& __two) {
return __two < __one;
}
template
constexpr inline bool operator<=(
const array<_Tp, _Nm>& __one,
const array<_Tp, _Nm>& __two) {
return !(__one > __two);
}
template
constexpr inline bool operator>=(
const array<_Tp, _Nm>& __one,
const array<_Tp, _Nm>& __two) {
return !(__one < __two);
}
// Specialized algorithms.
template
inline void swap(array<_Tp, _Nm>& __one, array<_Tp, _Nm>& __two) noexcept(
noexcept(__one.swap(__two))) {
__one.swap(__two);
}
template
constexpr _Tp& get(array<_Tp, _Nm>& __arr) noexcept {
static_assert(_Int < _Nm, "array index is within bounds");
return detail::__array_traits<_Tp, _Nm>::_S_ref(__arr._M_elems, _Int);
}
template
constexpr _Tp&& get(array<_Tp, _Nm>&& __arr) noexcept {
static_assert(_Int < _Nm, "array index is within bounds");
return std::move(get<_Int>(__arr));
}
template
constexpr const _Tp& get(const array<_Tp, _Nm>& __arr) noexcept {
static_assert(_Int < _Nm, "array index is within bounds");
return detail::__array_traits<_Tp, _Nm>::_S_ref(__arr._M_elems, _Int);
}
/**
* Some added features not available in std::array.
* Only call these at compile time, they're slow if called at runtime.
* Examples:
* tail({2, 3, 4}) == {3, 4}
* prepend(2, {3, 4}) == {2, 3, 4}
*/
namespace detail {
template
constexpr inline array tail_(
const array& arg,
std::index_sequence) {
static_assert(sizeof...(INDEX) == N - 1, "invariant");
return {{get(arg)...}};
}
} // namespace detail
template
constexpr inline array tail(const array& arg) {
static_assert(
N > 0, "Can only call tail() on an array with at least one element");
return detail::tail_(arg, std::make_index_sequence());
}
namespace detail {
template
constexpr inline array prepend_(
T&& head,
const array& tail,
std::index_sequence) {
return {{std::forward(head), get(tail)...}};
}
} // namespace detail
template
constexpr inline array prepend(T&& head, const array& tail) {
return detail::prepend_(
std::forward(head), tail, std::make_index_sequence());
}
/**
* Convert a C array into a std::array.
* Example:
* int source[3] = {2, 3, 4};
* std::array target = to_std_array(source);
*/
namespace detail {
template
constexpr array to_array_(
const T (&arr)[N],
std::index_sequence) {
return {{arr[INDEX]...}};
}
} // namespace detail
template
constexpr array to_array(const T (&arr)[N]) {
return detail::to_array_(arr, std::make_index_sequence());
}
} // namespace guts
} // namespace c10