1// <memory> -*- C++ -*-
2
3// Copyright (C) 2001-2023 Free Software Foundation, Inc.
4//
5// This file is part of the GNU ISO C++ Library. This library is free
6// software; you can redistribute it and/or modify it under the
7// terms of the GNU General Public License as published by the
8// Free Software Foundation; either version 3, or (at your option)
9// any later version.
10
11// This library is distributed in the hope that it will be useful,
12// but WITHOUT ANY WARRANTY; without even the implied warranty of
13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14// GNU General Public License for more details.
15
16// Under Section 7 of GPL version 3, you are granted additional
17// permissions described in the GCC Runtime Library Exception, version
18// 3.1, as published by the Free Software Foundation.
19
20// You should have received a copy of the GNU General Public License and
21// a copy of the GCC Runtime Library Exception along with this program;
22// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
23// <http://www.gnu.org/licenses/>.
24
25/*
26 * Copyright (c) 1997-1999
27 * Silicon Graphics Computer Systems, Inc.
28 *
29 * Permission to use, copy, modify, distribute and sell this software
30 * and its documentation for any purpose is hereby granted without fee,
31 * provided that the above copyright notice appear in all copies and
32 * that both that copyright notice and this permission notice appear
33 * in supporting documentation. Silicon Graphics makes no
34 * representations about the suitability of this software for any
35 * purpose. It is provided "as is" without express or implied warranty.
36 *
37 */
38
39/** @file include/memory
40 * This is a Standard C++ Library header.
41 * @ingroup memory
42 */
43
44#ifndef _GLIBCXX_MEMORY
45#define _GLIBCXX_MEMORY 1
46
47#pragma GCC system_header
48
49/**
50 * @defgroup memory Memory
51 * @ingroup utilities
52 *
53 * Components for memory allocation, deallocation, and management.
54 */
55
56/**
57 * @defgroup pointer_abstractions Pointer Abstractions
58 * @ingroup memory
59 *
60 * Smart pointers, etc.
61 */
62
63#include <bits/memoryfwd.h>
64#if _GLIBCXX_HOSTED
65# include <bits/allocator.h>
66# include <bits/stl_tempbuf.h>
67#endif
68#include <bits/stl_construct.h>
69#include <bits/stl_uninitialized.h>
70#include <bits/stl_raw_storage_iter.h>
71
72#if __cplusplus >= 201103L
73# include <type_traits>
74# include <bits/align.h>
75# include <bits/uses_allocator.h>
76# include <bits/alloc_traits.h>
77# include <debug/debug.h>
78# include <bits/unique_ptr.h>
79# if _GLIBCXX_HOSTED
80# include <bits/shared_ptr.h>
81# include <bits/shared_ptr_atomic.h>
82# endif
83#endif
84
85#if __cplusplus < 201103L || _GLIBCXX_USE_DEPRECATED
86# include <backward/auto_ptr.h>
87#endif
88
89#if __cplusplus > 201703L
90# include <bits/ranges_uninitialized.h>
91# include <bits/uses_allocator_args.h>
92#endif
93
94/* As a hack, we declare __cpp_lib_atomic_value_initialization here even though
95 we don't include the bit that actually declares it, for consistency. */
96#if !defined(__cpp_lib_atomic_value_initialization) && __cplusplus >= 202002L
97# define __cpp_lib_atomic_value_initialization 201911L
98#endif
99
100#if __cplusplus >= 201103L && __cplusplus <= 202002L && _GLIBCXX_HOSTED
101namespace std _GLIBCXX_VISIBILITY(default)
102{
103_GLIBCXX_BEGIN_NAMESPACE_VERSION
104
105/** @defgroup ptr_safety Pointer Safety and Garbage Collection
106 * @ingroup memory
107 *
108 * Utilities to assist with garbage collection in an implementation
109 * that supports <em>strict pointer safety</em>.
110 * This implementation only supports <em>relaxed pointer safety</em>
111 * and so these functions have no effect.
112 *
113 * C++11 20.6.4 [util.dynamic.safety], Pointer safety
114 *
115 * @{
116 */
117
118/// Constants representing the different types of pointer safety.
119enum class pointer_safety { relaxed, preferred, strict };
120
121/// Inform a garbage collector that an object is still in use.
122inline void
123declare_reachable(void*) { }
124
125/// Unregister an object previously registered with declare_reachable.
126template <typename _Tp>
127 inline _Tp*
128 undeclare_reachable(_Tp* __p) { return __p; }
129
130/// Inform a garbage collector that a region of memory need not be traced.
131inline void
132declare_no_pointers(char*, size_t) { }
133
134/// Unregister a range previously registered with declare_no_pointers.
135inline void
136undeclare_no_pointers(char*, size_t) { }
137
138/// The type of pointer safety supported by the implementation.
139inline pointer_safety
140get_pointer_safety() noexcept { return pointer_safety::relaxed; }
141/// @}
142
143_GLIBCXX_END_NAMESPACE_VERSION
144} // namespace
145#endif // C++11 to C++20
146
147#if __cplusplus >= 201703L && _GLIBCXX_HOSTED
148// Parallel STL algorithms
149# if _PSTL_EXECUTION_POLICIES_DEFINED
150// If <execution> has already been included, pull in implementations
151# include <pstl/glue_memory_impl.h>
152# else
153// Otherwise just pull in forward declarations
154# include <pstl/glue_memory_defs.h>
155# endif
156
157// Feature test macro for parallel algorithms
158# define __cpp_lib_parallel_algorithm 201603L
159#endif // C++17
160
161#endif /* _GLIBCXX_MEMORY */
162