xref: /freebsd/contrib/llvm-project/libcxx/include/__iterator/access.h (revision dab59af3bcc7cb7ba01569d3044894b3e860ad56)
1 // -*- C++ -*-
2 //===----------------------------------------------------------------------===//
3 //
4 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5 // See https://llvm.org/LICENSE.txt for license information.
6 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #ifndef _LIBCPP___ITERATOR_ACCESS_H
11 #define _LIBCPP___ITERATOR_ACCESS_H
12 
13 #include <__config>
14 #include <cstddef>
15 
16 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
17 #  pragma GCC system_header
18 #endif
19 
20 _LIBCPP_BEGIN_NAMESPACE_STD
21 
22 template <class _Tp, size_t _Np>
23 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR _Tp* begin(_Tp (&__array)[_Np]) _NOEXCEPT {
24   return __array;
25 }
26 
27 template <class _Tp, size_t _Np>
28 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR _Tp* end(_Tp (&__array)[_Np]) _NOEXCEPT {
29   return __array + _Np;
30 }
31 
32 #if !defined(_LIBCPP_CXX03_LANG)
33 
34 template <class _Cp>
35 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto begin(_Cp& __c) -> decltype(__c.begin()) {
36   return __c.begin();
37 }
38 
39 template <class _Cp>
40 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto begin(const _Cp& __c) -> decltype(__c.begin()) {
41   return __c.begin();
42 }
43 
44 template <class _Cp>
45 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto end(_Cp& __c) -> decltype(__c.end()) {
46   return __c.end();
47 }
48 
49 template <class _Cp>
50 _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX17 auto end(const _Cp& __c) -> decltype(__c.end()) {
51   return __c.end();
52 }
53 
54 #  if _LIBCPP_STD_VER >= 14
55 
56 template <class _Cp>
57 _LIBCPP_HIDE_FROM_ABI constexpr auto
58 cbegin(const _Cp& __c) noexcept(noexcept(std::begin(__c))) -> decltype(std::begin(__c)) {
59   return std::begin(__c);
60 }
61 
62 template <class _Cp>
63 _LIBCPP_HIDE_FROM_ABI constexpr auto cend(const _Cp& __c) noexcept(noexcept(std::end(__c))) -> decltype(std::end(__c)) {
64   return std::end(__c);
65 }
66 
67 #  endif
68 
69 #else // defined(_LIBCPP_CXX03_LANG)
70 
71 template <class _Cp>
72 _LIBCPP_HIDE_FROM_ABI typename _Cp::iterator begin(_Cp& __c) {
73   return __c.begin();
74 }
75 
76 template <class _Cp>
77 _LIBCPP_HIDE_FROM_ABI typename _Cp::const_iterator begin(const _Cp& __c) {
78   return __c.begin();
79 }
80 
81 template <class _Cp>
82 _LIBCPP_HIDE_FROM_ABI typename _Cp::iterator end(_Cp& __c) {
83   return __c.end();
84 }
85 
86 template <class _Cp>
87 _LIBCPP_HIDE_FROM_ABI typename _Cp::const_iterator end(const _Cp& __c) {
88   return __c.end();
89 }
90 
91 #endif // !defined(_LIBCPP_CXX03_LANG)
92 
93 _LIBCPP_END_NAMESPACE_STD
94 
95 #endif // _LIBCPP___ITERATOR_ACCESS_H
96