libcxx/include/__iterator/data.h

   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_DATA_H
  11 #define _LIBCPP___ITERATOR_DATA_H
  12
  13 #include <__config>
  14 #include <cstddef>
  15 #include <initializer_list>
  16
  17 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
  18 #  pragma GCC system_header
  19 #endif
  20
  21 _LIBCPP_BEGIN_NAMESPACE_STD
  22
  23 #if _LIBCPP_STD_VER >= 17
  24
  25 template <class _Cont> constexpr
  26 _LIBCPP_INLINE_VISIBILITY
  27 auto data(_Cont& __c)
  28 _NOEXCEPT_(noexcept(__c.data()))
  29 -> decltype        (__c.data())
  30 { return            __c.data(); }
  31
  32 template <class _Cont> constexpr
  33 _LIBCPP_INLINE_VISIBILITY
  34 auto data(const _Cont& __c)
  35 _NOEXCEPT_(noexcept(__c.data()))
  36 -> decltype        (__c.data())
  37 { return            __c.data(); }
  38
  39 template <class _Tp, size_t _Sz>
  40 _LIBCPP_INLINE_VISIBILITY
  41 constexpr _Tp* data(_Tp (&__array)[_Sz]) noexcept { return __array; }
  42
  43 template <class _Ep>
  44 _LIBCPP_INLINE_VISIBILITY
  45 constexpr const _Ep* data(initializer_list<_Ep> __il) noexcept { return __il.begin(); }
  46
  47 #endif
  48
  49 _LIBCPP_END_NAMESPACE_STD
  50
  51 #endif // _LIBCPP___ITERATOR_DATA_H