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___MEMORY_ADDRESSOF_H
11#define _LIBCPP___MEMORY_ADDRESSOF_H
12
13#include <__config>
14
15#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
16# pragma GCC system_header
17#endif
18
19_LIBCPP_BEGIN_NAMESPACE_STD
20
21template <class _Tp>
22inline _LIBCPP_CONSTEXPR_SINCE_CXX17 _LIBCPP_NO_CFI _LIBCPP_HIDE_FROM_ABI _Tp* addressof(_Tp& __x) _NOEXCEPT {
23 return __builtin_addressof(__x);
24}
25
26#if defined(_LIBCPP_HAS_OBJC_ARC) && !defined(_LIBCPP_PREDEFINED_OBJC_ARC_ADDRESSOF)
27// Objective-C++ Automatic Reference Counting uses qualified pointers
28// that require special addressof() signatures. When
29// _LIBCPP_PREDEFINED_OBJC_ARC_ADDRESSOF is defined, the compiler
30// itself is providing these definitions. Otherwise, we provide them.
31template <class _Tp>
32inline _LIBCPP_HIDE_FROM_ABI __strong _Tp* addressof(__strong _Tp& __x) _NOEXCEPT {
33 return &__x;
34}
35
36# ifdef _LIBCPP_HAS_OBJC_ARC_WEAK
37template <class _Tp>
38inline _LIBCPP_HIDE_FROM_ABI __weak _Tp* addressof(__weak _Tp& __x) _NOEXCEPT {
39 return &__x;
40}
41# endif
42
43template <class _Tp>
44inline _LIBCPP_HIDE_FROM_ABI __autoreleasing _Tp* addressof(__autoreleasing _Tp& __x) _NOEXCEPT {
45 return &__x;
46}
47
48template <class _Tp>
49inline _LIBCPP_HIDE_FROM_ABI __unsafe_unretained _Tp* addressof(__unsafe_unretained _Tp& __x) _NOEXCEPT {
50 return &__x;
51}
52#endif
53
54#if !defined(_LIBCPP_CXX03_LANG)
55template <class _Tp>
56_Tp* addressof(const _Tp&&) noexcept = delete;
57#endif
58
59_LIBCPP_END_NAMESPACE_STD
60
61#endif // _LIBCPP___MEMORY_ADDRESSOF_H
62