libcxx/include/__iterator/reverse_access.h

// -*- C++ -*-
//===----------------------------------------------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//

#ifndef _LIBCPP___ITERATOR_REVERSE_ACCESS_H
#define _LIBCPP___ITERATOR_REVERSE_ACCESS_H

#include <__config>
#include <__iterator/reverse_iterator.h>
#include <initializer_list>

#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
#  pragma GCC system_header
#endif

#if _LIBCPP_STD_VER >= 14

_LIBCPP_BEGIN_NAMESPACE_STD

template <class _Tp, size_t _Np>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reverse_iterator<_Tp*>
rbegin(_Tp (&__array)[_Np]) noexcept {
  return reverse_iterator<_Tp*>(__array + _Np);
}

template <class _Tp, size_t _Np>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reverse_iterator<_Tp*>
rend(_Tp (&__array)[_Np]) noexcept {
  return reverse_iterator<_Tp*>(__array);
}

template <class _Ep>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reverse_iterator<const _Ep*>
rbegin(initializer_list<_Ep> __il) noexcept {
  return reverse_iterator<const _Ep*>(__il.end());
}

template <class _Ep>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 reverse_iterator<const _Ep*>
rend(initializer_list<_Ep> __il) noexcept {
  return reverse_iterator<const _Ep*>(__il.begin());
}

template <class _Cp>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto rbegin(_Cp& __c) //
    noexcept(noexcept(__c.rbegin()))                                                        //
    -> decltype(/*-*/ __c.rbegin()) {
  return /*--------*/ __c.rbegin();
}

template <class _Cp>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto rbegin(const _Cp& __c) //
    noexcept(noexcept(__c.rbegin()))                                                              //
    -> decltype(/*-*/ __c.rbegin()) {
  return /*--------*/ __c.rbegin();
}

template <class _Cp>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto rend(_Cp& __c) //
    noexcept(noexcept(__c.rend()))                                                        //
    -> decltype(/*-*/ __c.rend()) {
  return /*--------*/ __c.rend();
}

template <class _Cp>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto rend(const _Cp& __c) //
    noexcept(noexcept(__c.rend()))                                                              //
    -> decltype(/*-*/ __c.rend()) {
  return /*--------*/ __c.rend();
}

template <class _Cp>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto crbegin(const _Cp& __c) //
    noexcept(noexcept(std::rbegin(__c)))                                                           //
    -> decltype(/*-*/ std::rbegin(__c)) {
  return /*--------*/ std::rbegin(__c);
}

template <class _Cp>
[[__nodiscard__]] _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto crend(const _Cp& __c) //
    noexcept(noexcept(std::rend(__c)))                                                           //
    -> decltype(/*-*/ std::rend(__c)) {
  return /*--------*/ std::rend(__c);
}

_LIBCPP_END_NAMESPACE_STD

#endif // _LIBCPP_STD_VER >= 14

#endif // _LIBCPP___ITERATOR_REVERSE_ACCESS_H