Where Online Learning is simpler!

The C and C++ Include Header Files

/usr/include/c++/13/memory


$ cat -n /usr/include/c++/13/memory

     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
   101	namespace 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.
   119	enum class pointer_safety { relaxed, preferred, strict };
   120	
   121	/// Inform a garbage collector that an object is still in use.
   122	inline void
   123	declare_reachable(void*) { }
   124	
   125	/// Unregister an object previously registered with declare_reachable.
   126	template <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.
   131	inline void
   132	declare_no_pointers(char*, size_t) { }
   133	
   134	/// Unregister a range previously registered with declare_no_pointers.
   135	inline void
   136	undeclare_no_pointers(char*, size_t) { }
   137	
   138	/// The type of pointer safety supported by the implementation.
   139	inline pointer_safety
   140	get_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 */