11debfc3dSmrg // shared_ptr and weak_ptr implementation -*- C++ -*-
21debfc3dSmrg
3*8feb0f0bSmrg // Copyright (C) 2007-2020 Free Software Foundation, Inc.
41debfc3dSmrg //
51debfc3dSmrg // This file is part of the GNU ISO C++ Library. This library is free
61debfc3dSmrg // software; you can redistribute it and/or modify it under the
71debfc3dSmrg // terms of the GNU General Public License as published by the
81debfc3dSmrg // Free Software Foundation; either version 3, or (at your option)
91debfc3dSmrg // any later version.
101debfc3dSmrg
111debfc3dSmrg // This library is distributed in the hope that it will be useful,
121debfc3dSmrg // but WITHOUT ANY WARRANTY; without even the implied warranty of
131debfc3dSmrg // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
141debfc3dSmrg // GNU General Public License for more details.
151debfc3dSmrg
161debfc3dSmrg // Under Section 7 of GPL version 3, you are granted additional
171debfc3dSmrg // permissions described in the GCC Runtime Library Exception, version
181debfc3dSmrg // 3.1, as published by the Free Software Foundation.
191debfc3dSmrg
201debfc3dSmrg // You should have received a copy of the GNU General Public License and
211debfc3dSmrg // a copy of the GCC Runtime Library Exception along with this program;
221debfc3dSmrg // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
231debfc3dSmrg // <http://www.gnu.org/licenses/>.
241debfc3dSmrg
251debfc3dSmrg // GCC Note: Based on files from version 1.32.0 of the Boost library.
261debfc3dSmrg
271debfc3dSmrg // shared_count.hpp
281debfc3dSmrg // Copyright (c) 2001, 2002, 2003 Peter Dimov and Multi Media Ltd.
291debfc3dSmrg
301debfc3dSmrg // shared_ptr.hpp
311debfc3dSmrg // Copyright (C) 1998, 1999 Greg Colvin and Beman Dawes.
321debfc3dSmrg // Copyright (C) 2001, 2002, 2003 Peter Dimov
331debfc3dSmrg
341debfc3dSmrg // weak_ptr.hpp
351debfc3dSmrg // Copyright (C) 2001, 2002, 2003 Peter Dimov
361debfc3dSmrg
371debfc3dSmrg // enable_shared_from_this.hpp
381debfc3dSmrg // Copyright (C) 2002 Peter Dimov
391debfc3dSmrg
401debfc3dSmrg // Distributed under the Boost Software License, Version 1.0. (See
411debfc3dSmrg // accompanying file LICENSE_1_0.txt or copy at
421debfc3dSmrg // http://www.boost.org/LICENSE_1_0.txt)
431debfc3dSmrg
441debfc3dSmrg /** @file
451debfc3dSmrg * This is an internal header file, included by other library headers.
461debfc3dSmrg * Do not attempt to use it directly. @headername{memory}
471debfc3dSmrg */
481debfc3dSmrg
491debfc3dSmrg #ifndef _SHARED_PTR_H
501debfc3dSmrg #define _SHARED_PTR_H 1
511debfc3dSmrg
521debfc3dSmrg #include <bits/shared_ptr_base.h>
531debfc3dSmrg
_GLIBCXX_VISIBILITY(default)541debfc3dSmrg namespace std _GLIBCXX_VISIBILITY(default)
551debfc3dSmrg {
561debfc3dSmrg _GLIBCXX_BEGIN_NAMESPACE_VERSION
571debfc3dSmrg
581debfc3dSmrg /**
591debfc3dSmrg * @addtogroup pointer_abstractions
601debfc3dSmrg * @{
611debfc3dSmrg */
621debfc3dSmrg
63*8feb0f0bSmrg // 20.7.2.2.11 shared_ptr I/O
64*8feb0f0bSmrg
65*8feb0f0bSmrg /// Write the stored pointer to an ostream.
66*8feb0f0bSmrg /// @relates shared_ptr
671debfc3dSmrg template<typename _Ch, typename _Tr, typename _Tp, _Lock_policy _Lp>
681debfc3dSmrg inline std::basic_ostream<_Ch, _Tr>&
691debfc3dSmrg operator<<(std::basic_ostream<_Ch, _Tr>& __os,
701debfc3dSmrg const __shared_ptr<_Tp, _Lp>& __p)
711debfc3dSmrg {
721debfc3dSmrg __os << __p.get();
731debfc3dSmrg return __os;
741debfc3dSmrg }
751debfc3dSmrg
761debfc3dSmrg template<typename _Del, typename _Tp, _Lock_policy _Lp>
771debfc3dSmrg inline _Del*
781debfc3dSmrg get_deleter(const __shared_ptr<_Tp, _Lp>& __p) noexcept
791debfc3dSmrg {
801debfc3dSmrg #if __cpp_rtti
811debfc3dSmrg return static_cast<_Del*>(__p._M_get_deleter(typeid(_Del)));
821debfc3dSmrg #else
831debfc3dSmrg return 0;
841debfc3dSmrg #endif
851debfc3dSmrg }
861debfc3dSmrg
87a2dc1f3fSmrg /// 20.7.2.2.10 shared_ptr get_deleter
88*8feb0f0bSmrg
89*8feb0f0bSmrg /// If `__p` has a deleter of type `_Del`, return a pointer to it.
90*8feb0f0bSmrg /// @relates shared_ptr
91a2dc1f3fSmrg template<typename _Del, typename _Tp>
92a2dc1f3fSmrg inline _Del*
93a2dc1f3fSmrg get_deleter(const shared_ptr<_Tp>& __p) noexcept
94a2dc1f3fSmrg {
95a2dc1f3fSmrg #if __cpp_rtti
96a2dc1f3fSmrg return static_cast<_Del*>(__p._M_get_deleter(typeid(_Del)));
97a2dc1f3fSmrg #else
98a2dc1f3fSmrg return 0;
99a2dc1f3fSmrg #endif
100a2dc1f3fSmrg }
1011debfc3dSmrg
1021debfc3dSmrg /**
1031debfc3dSmrg * @brief A smart pointer with reference-counted copy semantics.
1041debfc3dSmrg *
105*8feb0f0bSmrg * A `shared_ptr` object is either empty or _owns_ a pointer passed
106*8feb0f0bSmrg * to the constructor. Copies of a `shared_ptr` share ownership of
107*8feb0f0bSmrg * the same pointer. When the last `shared_ptr` that owns the pointer
108*8feb0f0bSmrg * is destroyed or reset, the owned pointer is freed (either by `delete`
109*8feb0f0bSmrg * or by invoking a custom deleter that was passed to the constructor).
110*8feb0f0bSmrg *
111*8feb0f0bSmrg * A `shared_ptr` also stores another pointer, which is usually
112*8feb0f0bSmrg * (but not always) the same pointer as it owns. The stored pointer
113*8feb0f0bSmrg * can be retrieved by calling the `get()` member function.
114*8feb0f0bSmrg *
115*8feb0f0bSmrg * The equality and relational operators for `shared_ptr` only compare
116*8feb0f0bSmrg * the stored pointer returned by `get()`, not the owned pointer.
117*8feb0f0bSmrg * To test whether two `shared_ptr` objects share ownership of the same
118*8feb0f0bSmrg * pointer see `std::shared_ptr::owner_before` and `std::owner_less`.
1191debfc3dSmrg */
1201debfc3dSmrg template<typename _Tp>
1211debfc3dSmrg class shared_ptr : public __shared_ptr<_Tp>
1221debfc3dSmrg {
1231debfc3dSmrg template<typename... _Args>
1241debfc3dSmrg using _Constructible = typename enable_if<
1251debfc3dSmrg is_constructible<__shared_ptr<_Tp>, _Args...>::value
1261debfc3dSmrg >::type;
1271debfc3dSmrg
1281debfc3dSmrg template<typename _Arg>
1291debfc3dSmrg using _Assignable = typename enable_if<
1301debfc3dSmrg is_assignable<__shared_ptr<_Tp>&, _Arg>::value, shared_ptr&
1311debfc3dSmrg >::type;
1321debfc3dSmrg
1331debfc3dSmrg public:
1341debfc3dSmrg
135*8feb0f0bSmrg /// The type pointed to by the stored pointer, remove_extent_t<_Tp>
1361debfc3dSmrg using element_type = typename __shared_ptr<_Tp>::element_type;
1371debfc3dSmrg
138*8feb0f0bSmrg #if __cplusplus >= 201703L
1391debfc3dSmrg # define __cpp_lib_shared_ptr_weak_type 201606
140*8feb0f0bSmrg /// The corresponding weak_ptr type for this shared_ptr
1411debfc3dSmrg using weak_type = weak_ptr<_Tp>;
1421debfc3dSmrg #endif
1431debfc3dSmrg /**
1441debfc3dSmrg * @brief Construct an empty %shared_ptr.
1451debfc3dSmrg * @post use_count()==0 && get()==0
1461debfc3dSmrg */
1471debfc3dSmrg constexpr shared_ptr() noexcept : __shared_ptr<_Tp>() { }
1481debfc3dSmrg
149*8feb0f0bSmrg shared_ptr(const shared_ptr&) noexcept = default; ///< Copy constructor
1501debfc3dSmrg
1511debfc3dSmrg /**
1521debfc3dSmrg * @brief Construct a %shared_ptr that owns the pointer @a __p.
1531debfc3dSmrg * @param __p A pointer that is convertible to element_type*.
1541debfc3dSmrg * @post use_count() == 1 && get() == __p
1551debfc3dSmrg * @throw std::bad_alloc, in which case @c delete @a __p is called.
1561debfc3dSmrg */
1571debfc3dSmrg template<typename _Yp, typename = _Constructible<_Yp*>>
1581debfc3dSmrg explicit
1591debfc3dSmrg shared_ptr(_Yp* __p) : __shared_ptr<_Tp>(__p) { }
1601debfc3dSmrg
1611debfc3dSmrg /**
1621debfc3dSmrg * @brief Construct a %shared_ptr that owns the pointer @a __p
1631debfc3dSmrg * and the deleter @a __d.
1641debfc3dSmrg * @param __p A pointer.
1651debfc3dSmrg * @param __d A deleter.
1661debfc3dSmrg * @post use_count() == 1 && get() == __p
1671debfc3dSmrg * @throw std::bad_alloc, in which case @a __d(__p) is called.
1681debfc3dSmrg *
1691debfc3dSmrg * Requirements: _Deleter's copy constructor and destructor must
1701debfc3dSmrg * not throw
1711debfc3dSmrg *
1721debfc3dSmrg * __shared_ptr will release __p by calling __d(__p)
1731debfc3dSmrg */
1741debfc3dSmrg template<typename _Yp, typename _Deleter,
1751debfc3dSmrg typename = _Constructible<_Yp*, _Deleter>>
1761debfc3dSmrg shared_ptr(_Yp* __p, _Deleter __d)
1771debfc3dSmrg : __shared_ptr<_Tp>(__p, std::move(__d)) { }
1781debfc3dSmrg
1791debfc3dSmrg /**
1801debfc3dSmrg * @brief Construct a %shared_ptr that owns a null pointer
1811debfc3dSmrg * and the deleter @a __d.
1821debfc3dSmrg * @param __p A null pointer constant.
1831debfc3dSmrg * @param __d A deleter.
1841debfc3dSmrg * @post use_count() == 1 && get() == __p
1851debfc3dSmrg * @throw std::bad_alloc, in which case @a __d(__p) is called.
1861debfc3dSmrg *
1871debfc3dSmrg * Requirements: _Deleter's copy constructor and destructor must
1881debfc3dSmrg * not throw
1891debfc3dSmrg *
1901debfc3dSmrg * The last owner will call __d(__p)
1911debfc3dSmrg */
1921debfc3dSmrg template<typename _Deleter>
1931debfc3dSmrg shared_ptr(nullptr_t __p, _Deleter __d)
1941debfc3dSmrg : __shared_ptr<_Tp>(__p, std::move(__d)) { }
1951debfc3dSmrg
1961debfc3dSmrg /**
1971debfc3dSmrg * @brief Construct a %shared_ptr that owns the pointer @a __p
1981debfc3dSmrg * and the deleter @a __d.
1991debfc3dSmrg * @param __p A pointer.
2001debfc3dSmrg * @param __d A deleter.
2011debfc3dSmrg * @param __a An allocator.
2021debfc3dSmrg * @post use_count() == 1 && get() == __p
2031debfc3dSmrg * @throw std::bad_alloc, in which case @a __d(__p) is called.
2041debfc3dSmrg *
2051debfc3dSmrg * Requirements: _Deleter's copy constructor and destructor must
2061debfc3dSmrg * not throw _Alloc's copy constructor and destructor must not
2071debfc3dSmrg * throw.
2081debfc3dSmrg *
2091debfc3dSmrg * __shared_ptr will release __p by calling __d(__p)
2101debfc3dSmrg */
2111debfc3dSmrg template<typename _Yp, typename _Deleter, typename _Alloc,
2121debfc3dSmrg typename = _Constructible<_Yp*, _Deleter, _Alloc>>
2131debfc3dSmrg shared_ptr(_Yp* __p, _Deleter __d, _Alloc __a)
2141debfc3dSmrg : __shared_ptr<_Tp>(__p, std::move(__d), std::move(__a)) { }
2151debfc3dSmrg
2161debfc3dSmrg /**
2171debfc3dSmrg * @brief Construct a %shared_ptr that owns a null pointer
2181debfc3dSmrg * and the deleter @a __d.
2191debfc3dSmrg * @param __p A null pointer constant.
2201debfc3dSmrg * @param __d A deleter.
2211debfc3dSmrg * @param __a An allocator.
2221debfc3dSmrg * @post use_count() == 1 && get() == __p
2231debfc3dSmrg * @throw std::bad_alloc, in which case @a __d(__p) is called.
2241debfc3dSmrg *
2251debfc3dSmrg * Requirements: _Deleter's copy constructor and destructor must
2261debfc3dSmrg * not throw _Alloc's copy constructor and destructor must not
2271debfc3dSmrg * throw.
2281debfc3dSmrg *
2291debfc3dSmrg * The last owner will call __d(__p)
2301debfc3dSmrg */
2311debfc3dSmrg template<typename _Deleter, typename _Alloc>
2321debfc3dSmrg shared_ptr(nullptr_t __p, _Deleter __d, _Alloc __a)
2331debfc3dSmrg : __shared_ptr<_Tp>(__p, std::move(__d), std::move(__a)) { }
2341debfc3dSmrg
2351debfc3dSmrg // Aliasing constructor
2361debfc3dSmrg
2371debfc3dSmrg /**
238*8feb0f0bSmrg * @brief Constructs a `shared_ptr` instance that stores `__p`
239*8feb0f0bSmrg * and shares ownership with `__r`.
240*8feb0f0bSmrg * @param __r A `shared_ptr`.
241*8feb0f0bSmrg * @param __p A pointer that will remain valid while `*__r` is valid.
242*8feb0f0bSmrg * @post `get() == __p && use_count() == __r.use_count()`
2431debfc3dSmrg *
244*8feb0f0bSmrg * This can be used to construct a `shared_ptr` to a sub-object
245*8feb0f0bSmrg * of an object managed by an existing `shared_ptr`. The complete
246*8feb0f0bSmrg * object will remain valid while any `shared_ptr` owns it, even
247*8feb0f0bSmrg * if they don't store a pointer to the complete object.
2481debfc3dSmrg *
2491debfc3dSmrg * @code
2501debfc3dSmrg * shared_ptr<pair<int,int>> pii(new pair<int,int>());
2511debfc3dSmrg * shared_ptr<int> pi(pii, &pii->first);
2521debfc3dSmrg * assert(pii.use_count() == 2);
2531debfc3dSmrg * @endcode
2541debfc3dSmrg */
2551debfc3dSmrg template<typename _Yp>
2561debfc3dSmrg shared_ptr(const shared_ptr<_Yp>& __r, element_type* __p) noexcept
2571debfc3dSmrg : __shared_ptr<_Tp>(__r, __p) { }
2581debfc3dSmrg
259*8feb0f0bSmrg #if __cplusplus > 201703L
260*8feb0f0bSmrg // _GLIBCXX_RESOLVE_LIB_DEFECTS
261*8feb0f0bSmrg // 2996. Missing rvalue overloads for shared_ptr operations
262*8feb0f0bSmrg /**
263*8feb0f0bSmrg * @brief Constructs a `shared_ptr` instance that stores `__p`
264*8feb0f0bSmrg * and shares ownership with `__r`.
265*8feb0f0bSmrg * @param __r A `shared_ptr`.
266*8feb0f0bSmrg * @param __p A pointer that will remain valid while `*__r` is valid.
267*8feb0f0bSmrg * @post `get() == __p && !__r.use_count() && !__r.get()`
268*8feb0f0bSmrg *
269*8feb0f0bSmrg * This can be used to construct a `shared_ptr` to a sub-object
270*8feb0f0bSmrg * of an object managed by an existing `shared_ptr`. The complete
271*8feb0f0bSmrg * object will remain valid while any `shared_ptr` owns it, even
272*8feb0f0bSmrg * if they don't store a pointer to the complete object.
273*8feb0f0bSmrg *
274*8feb0f0bSmrg * @code
275*8feb0f0bSmrg * shared_ptr<pair<int,int>> pii(new pair<int,int>());
276*8feb0f0bSmrg * shared_ptr<int> pi1(pii, &pii->first);
277*8feb0f0bSmrg * assert(pii.use_count() == 2);
278*8feb0f0bSmrg * shared_ptr<int> pi2(std::move(pii), &pii->second);
279*8feb0f0bSmrg * assert(pii.use_count() == 0);
280*8feb0f0bSmrg * @endcode
281*8feb0f0bSmrg */
282*8feb0f0bSmrg template<typename _Yp>
283*8feb0f0bSmrg shared_ptr(shared_ptr<_Yp>&& __r, element_type* __p) noexcept
284*8feb0f0bSmrg : __shared_ptr<_Tp>(std::move(__r), __p) { }
285*8feb0f0bSmrg #endif
2861debfc3dSmrg /**
2871debfc3dSmrg * @brief If @a __r is empty, constructs an empty %shared_ptr;
2881debfc3dSmrg * otherwise construct a %shared_ptr that shares ownership
2891debfc3dSmrg * with @a __r.
2901debfc3dSmrg * @param __r A %shared_ptr.
2911debfc3dSmrg * @post get() == __r.get() && use_count() == __r.use_count()
2921debfc3dSmrg */
2931debfc3dSmrg template<typename _Yp,
2941debfc3dSmrg typename = _Constructible<const shared_ptr<_Yp>&>>
2951debfc3dSmrg shared_ptr(const shared_ptr<_Yp>& __r) noexcept
2961debfc3dSmrg : __shared_ptr<_Tp>(__r) { }
2971debfc3dSmrg
2981debfc3dSmrg /**
2991debfc3dSmrg * @brief Move-constructs a %shared_ptr instance from @a __r.
3001debfc3dSmrg * @param __r A %shared_ptr rvalue.
3011debfc3dSmrg * @post *this contains the old value of @a __r, @a __r is empty.
3021debfc3dSmrg */
3031debfc3dSmrg shared_ptr(shared_ptr&& __r) noexcept
3041debfc3dSmrg : __shared_ptr<_Tp>(std::move(__r)) { }
3051debfc3dSmrg
3061debfc3dSmrg /**
3071debfc3dSmrg * @brief Move-constructs a %shared_ptr instance from @a __r.
3081debfc3dSmrg * @param __r A %shared_ptr rvalue.
3091debfc3dSmrg * @post *this contains the old value of @a __r, @a __r is empty.
3101debfc3dSmrg */
3111debfc3dSmrg template<typename _Yp, typename = _Constructible<shared_ptr<_Yp>>>
3121debfc3dSmrg shared_ptr(shared_ptr<_Yp>&& __r) noexcept
3131debfc3dSmrg : __shared_ptr<_Tp>(std::move(__r)) { }
3141debfc3dSmrg
3151debfc3dSmrg /**
3161debfc3dSmrg * @brief Constructs a %shared_ptr that shares ownership with @a __r
3171debfc3dSmrg * and stores a copy of the pointer stored in @a __r.
3181debfc3dSmrg * @param __r A weak_ptr.
3191debfc3dSmrg * @post use_count() == __r.use_count()
3201debfc3dSmrg * @throw bad_weak_ptr when __r.expired(),
3211debfc3dSmrg * in which case the constructor has no effect.
3221debfc3dSmrg */
3231debfc3dSmrg template<typename _Yp, typename = _Constructible<const weak_ptr<_Yp>&>>
3241debfc3dSmrg explicit shared_ptr(const weak_ptr<_Yp>& __r)
3251debfc3dSmrg : __shared_ptr<_Tp>(__r) { }
3261debfc3dSmrg
3271debfc3dSmrg #if _GLIBCXX_USE_DEPRECATED
328a2dc1f3fSmrg #pragma GCC diagnostic push
329a2dc1f3fSmrg #pragma GCC diagnostic ignored "-Wdeprecated-declarations"
3301debfc3dSmrg template<typename _Yp, typename = _Constructible<auto_ptr<_Yp>>>
3311debfc3dSmrg shared_ptr(auto_ptr<_Yp>&& __r);
332a2dc1f3fSmrg #pragma GCC diagnostic pop
3331debfc3dSmrg #endif
3341debfc3dSmrg
3351debfc3dSmrg // _GLIBCXX_RESOLVE_LIB_DEFECTS
3361debfc3dSmrg // 2399. shared_ptr's constructor from unique_ptr should be constrained
3371debfc3dSmrg template<typename _Yp, typename _Del,
3381debfc3dSmrg typename = _Constructible<unique_ptr<_Yp, _Del>>>
3391debfc3dSmrg shared_ptr(unique_ptr<_Yp, _Del>&& __r)
3401debfc3dSmrg : __shared_ptr<_Tp>(std::move(__r)) { }
3411debfc3dSmrg
3421debfc3dSmrg #if __cplusplus <= 201402L && _GLIBCXX_USE_DEPRECATED
3431debfc3dSmrg // This non-standard constructor exists to support conversions that
3441debfc3dSmrg // were possible in C++11 and C++14 but are ill-formed in C++17.
3451debfc3dSmrg // If an exception is thrown this constructor has no effect.
3461debfc3dSmrg template<typename _Yp, typename _Del,
3471debfc3dSmrg _Constructible<unique_ptr<_Yp, _Del>, __sp_array_delete>* = 0>
3481debfc3dSmrg shared_ptr(unique_ptr<_Yp, _Del>&& __r)
3491debfc3dSmrg : __shared_ptr<_Tp>(std::move(__r), __sp_array_delete()) { }
3501debfc3dSmrg #endif
3511debfc3dSmrg
3521debfc3dSmrg /**
3531debfc3dSmrg * @brief Construct an empty %shared_ptr.
3541debfc3dSmrg * @post use_count() == 0 && get() == nullptr
3551debfc3dSmrg */
3561debfc3dSmrg constexpr shared_ptr(nullptr_t) noexcept : shared_ptr() { }
3571debfc3dSmrg
3581debfc3dSmrg shared_ptr& operator=(const shared_ptr&) noexcept = default;
3591debfc3dSmrg
3601debfc3dSmrg template<typename _Yp>
3611debfc3dSmrg _Assignable<const shared_ptr<_Yp>&>
3621debfc3dSmrg operator=(const shared_ptr<_Yp>& __r) noexcept
3631debfc3dSmrg {
3641debfc3dSmrg this->__shared_ptr<_Tp>::operator=(__r);
3651debfc3dSmrg return *this;
3661debfc3dSmrg }
3671debfc3dSmrg
3681debfc3dSmrg #if _GLIBCXX_USE_DEPRECATED
369a2dc1f3fSmrg #pragma GCC diagnostic push
370a2dc1f3fSmrg #pragma GCC diagnostic ignored "-Wdeprecated-declarations"
3711debfc3dSmrg template<typename _Yp>
3721debfc3dSmrg _Assignable<auto_ptr<_Yp>>
3731debfc3dSmrg operator=(auto_ptr<_Yp>&& __r)
3741debfc3dSmrg {
3751debfc3dSmrg this->__shared_ptr<_Tp>::operator=(std::move(__r));
3761debfc3dSmrg return *this;
3771debfc3dSmrg }
378a2dc1f3fSmrg #pragma GCC diagnostic pop
3791debfc3dSmrg #endif
3801debfc3dSmrg
3811debfc3dSmrg shared_ptr&
3821debfc3dSmrg operator=(shared_ptr&& __r) noexcept
3831debfc3dSmrg {
3841debfc3dSmrg this->__shared_ptr<_Tp>::operator=(std::move(__r));
3851debfc3dSmrg return *this;
3861debfc3dSmrg }
3871debfc3dSmrg
3881debfc3dSmrg template<class _Yp>
3891debfc3dSmrg _Assignable<shared_ptr<_Yp>>
3901debfc3dSmrg operator=(shared_ptr<_Yp>&& __r) noexcept
3911debfc3dSmrg {
3921debfc3dSmrg this->__shared_ptr<_Tp>::operator=(std::move(__r));
3931debfc3dSmrg return *this;
3941debfc3dSmrg }
3951debfc3dSmrg
3961debfc3dSmrg template<typename _Yp, typename _Del>
3971debfc3dSmrg _Assignable<unique_ptr<_Yp, _Del>>
3981debfc3dSmrg operator=(unique_ptr<_Yp, _Del>&& __r)
3991debfc3dSmrg {
4001debfc3dSmrg this->__shared_ptr<_Tp>::operator=(std::move(__r));
4011debfc3dSmrg return *this;
4021debfc3dSmrg }
4031debfc3dSmrg
4041debfc3dSmrg private:
4051debfc3dSmrg // This constructor is non-standard, it is used by allocate_shared.
4061debfc3dSmrg template<typename _Alloc, typename... _Args>
407a2dc1f3fSmrg shared_ptr(_Sp_alloc_shared_tag<_Alloc> __tag, _Args&&... __args)
408a2dc1f3fSmrg : __shared_ptr<_Tp>(__tag, std::forward<_Args>(__args)...)
4091debfc3dSmrg { }
4101debfc3dSmrg
4111debfc3dSmrg template<typename _Yp, typename _Alloc, typename... _Args>
4121debfc3dSmrg friend shared_ptr<_Yp>
4131debfc3dSmrg allocate_shared(const _Alloc& __a, _Args&&... __args);
4141debfc3dSmrg
4151debfc3dSmrg // This constructor is non-standard, it is used by weak_ptr::lock().
4161debfc3dSmrg shared_ptr(const weak_ptr<_Tp>& __r, std::nothrow_t)
4171debfc3dSmrg : __shared_ptr<_Tp>(__r, std::nothrow) { }
4181debfc3dSmrg
4191debfc3dSmrg friend class weak_ptr<_Tp>;
4201debfc3dSmrg };
4211debfc3dSmrg
4221debfc3dSmrg #if __cpp_deduction_guides >= 201606
4231debfc3dSmrg template<typename _Tp>
4241debfc3dSmrg shared_ptr(weak_ptr<_Tp>) -> shared_ptr<_Tp>;
4251debfc3dSmrg template<typename _Tp, typename _Del>
4261debfc3dSmrg shared_ptr(unique_ptr<_Tp, _Del>) -> shared_ptr<_Tp>;
4271debfc3dSmrg #endif
4281debfc3dSmrg
4291debfc3dSmrg // 20.7.2.2.7 shared_ptr comparisons
430*8feb0f0bSmrg
431*8feb0f0bSmrg /// @relates shared_ptr @{
432*8feb0f0bSmrg
433*8feb0f0bSmrg /// Equality operator for shared_ptr objects, compares the stored pointers
4341debfc3dSmrg template<typename _Tp, typename _Up>
435c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
4361debfc3dSmrg operator==(const shared_ptr<_Tp>& __a, const shared_ptr<_Up>& __b) noexcept
4371debfc3dSmrg { return __a.get() == __b.get(); }
4381debfc3dSmrg
439*8feb0f0bSmrg /// shared_ptr comparison with nullptr
4401debfc3dSmrg template<typename _Tp>
441c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
4421debfc3dSmrg operator==(const shared_ptr<_Tp>& __a, nullptr_t) noexcept
4431debfc3dSmrg { return !__a; }
4441debfc3dSmrg
445*8feb0f0bSmrg #ifdef __cpp_lib_three_way_comparison
446*8feb0f0bSmrg template<typename _Tp, typename _Up>
447*8feb0f0bSmrg inline strong_ordering
448*8feb0f0bSmrg operator<=>(const shared_ptr<_Tp>& __a,
449*8feb0f0bSmrg const shared_ptr<_Up>& __b) noexcept
450*8feb0f0bSmrg { return compare_three_way()(__a.get(), __b.get()); }
451*8feb0f0bSmrg
452*8feb0f0bSmrg template<typename _Tp>
453*8feb0f0bSmrg inline strong_ordering
454*8feb0f0bSmrg operator<=>(const shared_ptr<_Tp>& __a, nullptr_t) noexcept
455*8feb0f0bSmrg {
456*8feb0f0bSmrg using pointer = typename shared_ptr<_Tp>::element_type*;
457*8feb0f0bSmrg return compare_three_way()(__a.get(), static_cast<pointer>(nullptr));
458*8feb0f0bSmrg }
459*8feb0f0bSmrg #else
460*8feb0f0bSmrg /// shared_ptr comparison with nullptr
4611debfc3dSmrg template<typename _Tp>
462c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
4631debfc3dSmrg operator==(nullptr_t, const shared_ptr<_Tp>& __a) noexcept
4641debfc3dSmrg { return !__a; }
4651debfc3dSmrg
466*8feb0f0bSmrg /// Inequality operator for shared_ptr objects, compares the stored pointers
4671debfc3dSmrg template<typename _Tp, typename _Up>
468c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
4691debfc3dSmrg operator!=(const shared_ptr<_Tp>& __a, const shared_ptr<_Up>& __b) noexcept
4701debfc3dSmrg { return __a.get() != __b.get(); }
4711debfc3dSmrg
472*8feb0f0bSmrg /// shared_ptr comparison with nullptr
4731debfc3dSmrg template<typename _Tp>
474c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
4751debfc3dSmrg operator!=(const shared_ptr<_Tp>& __a, nullptr_t) noexcept
4761debfc3dSmrg { return (bool)__a; }
4771debfc3dSmrg
478*8feb0f0bSmrg /// shared_ptr comparison with nullptr
4791debfc3dSmrg template<typename _Tp>
480c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
4811debfc3dSmrg operator!=(nullptr_t, const shared_ptr<_Tp>& __a) noexcept
4821debfc3dSmrg { return (bool)__a; }
4831debfc3dSmrg
484*8feb0f0bSmrg /// Relational operator for shared_ptr objects, compares the stored pointers
4851debfc3dSmrg template<typename _Tp, typename _Up>
486c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
4871debfc3dSmrg operator<(const shared_ptr<_Tp>& __a, const shared_ptr<_Up>& __b) noexcept
4881debfc3dSmrg {
4891debfc3dSmrg using _Tp_elt = typename shared_ptr<_Tp>::element_type;
4901debfc3dSmrg using _Up_elt = typename shared_ptr<_Up>::element_type;
4911debfc3dSmrg using _Vp = typename common_type<_Tp_elt*, _Up_elt*>::type;
4921debfc3dSmrg return less<_Vp>()(__a.get(), __b.get());
4931debfc3dSmrg }
4941debfc3dSmrg
495*8feb0f0bSmrg /// shared_ptr comparison with nullptr
4961debfc3dSmrg template<typename _Tp>
497c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
4981debfc3dSmrg operator<(const shared_ptr<_Tp>& __a, nullptr_t) noexcept
4991debfc3dSmrg {
5001debfc3dSmrg using _Tp_elt = typename shared_ptr<_Tp>::element_type;
5011debfc3dSmrg return less<_Tp_elt*>()(__a.get(), nullptr);
5021debfc3dSmrg }
5031debfc3dSmrg
504*8feb0f0bSmrg /// shared_ptr comparison with nullptr
5051debfc3dSmrg template<typename _Tp>
506c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5071debfc3dSmrg operator<(nullptr_t, const shared_ptr<_Tp>& __a) noexcept
5081debfc3dSmrg {
5091debfc3dSmrg using _Tp_elt = typename shared_ptr<_Tp>::element_type;
5101debfc3dSmrg return less<_Tp_elt*>()(nullptr, __a.get());
5111debfc3dSmrg }
5121debfc3dSmrg
513*8feb0f0bSmrg /// Relational operator for shared_ptr objects, compares the stored pointers
5141debfc3dSmrg template<typename _Tp, typename _Up>
515c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5161debfc3dSmrg operator<=(const shared_ptr<_Tp>& __a, const shared_ptr<_Up>& __b) noexcept
5171debfc3dSmrg { return !(__b < __a); }
5181debfc3dSmrg
519*8feb0f0bSmrg /// shared_ptr comparison with nullptr
5201debfc3dSmrg template<typename _Tp>
521c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5221debfc3dSmrg operator<=(const shared_ptr<_Tp>& __a, nullptr_t) noexcept
5231debfc3dSmrg { return !(nullptr < __a); }
5241debfc3dSmrg
525*8feb0f0bSmrg /// shared_ptr comparison with nullptr
5261debfc3dSmrg template<typename _Tp>
527c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5281debfc3dSmrg operator<=(nullptr_t, const shared_ptr<_Tp>& __a) noexcept
5291debfc3dSmrg { return !(__a < nullptr); }
5301debfc3dSmrg
531*8feb0f0bSmrg /// Relational operator for shared_ptr objects, compares the stored pointers
5321debfc3dSmrg template<typename _Tp, typename _Up>
533c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5341debfc3dSmrg operator>(const shared_ptr<_Tp>& __a, const shared_ptr<_Up>& __b) noexcept
5351debfc3dSmrg { return (__b < __a); }
5361debfc3dSmrg
537*8feb0f0bSmrg /// shared_ptr comparison with nullptr
5381debfc3dSmrg template<typename _Tp>
539c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5401debfc3dSmrg operator>(const shared_ptr<_Tp>& __a, nullptr_t) noexcept
5411debfc3dSmrg { return nullptr < __a; }
5421debfc3dSmrg
543*8feb0f0bSmrg /// shared_ptr comparison with nullptr
5441debfc3dSmrg template<typename _Tp>
545c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5461debfc3dSmrg operator>(nullptr_t, const shared_ptr<_Tp>& __a) noexcept
5471debfc3dSmrg { return __a < nullptr; }
5481debfc3dSmrg
549*8feb0f0bSmrg /// Relational operator for shared_ptr objects, compares the stored pointers
5501debfc3dSmrg template<typename _Tp, typename _Up>
551c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5521debfc3dSmrg operator>=(const shared_ptr<_Tp>& __a, const shared_ptr<_Up>& __b) noexcept
5531debfc3dSmrg { return !(__a < __b); }
5541debfc3dSmrg
555*8feb0f0bSmrg /// shared_ptr comparison with nullptr
5561debfc3dSmrg template<typename _Tp>
557c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5581debfc3dSmrg operator>=(const shared_ptr<_Tp>& __a, nullptr_t) noexcept
5591debfc3dSmrg { return !(__a < nullptr); }
5601debfc3dSmrg
561*8feb0f0bSmrg /// shared_ptr comparison with nullptr
5621debfc3dSmrg template<typename _Tp>
563c0a68be4Smrg _GLIBCXX_NODISCARD inline bool
5641debfc3dSmrg operator>=(nullptr_t, const shared_ptr<_Tp>& __a) noexcept
5651debfc3dSmrg { return !(nullptr < __a); }
566*8feb0f0bSmrg #endif
5671debfc3dSmrg
5681debfc3dSmrg // 20.7.2.2.8 shared_ptr specialized algorithms.
569*8feb0f0bSmrg
570*8feb0f0bSmrg /// Swap overload for shared_ptr
5711debfc3dSmrg template<typename _Tp>
5721debfc3dSmrg inline void
5731debfc3dSmrg swap(shared_ptr<_Tp>& __a, shared_ptr<_Tp>& __b) noexcept
5741debfc3dSmrg { __a.swap(__b); }
5751debfc3dSmrg
5761debfc3dSmrg // 20.7.2.2.9 shared_ptr casts.
577*8feb0f0bSmrg
578*8feb0f0bSmrg /// Convert type of `shared_ptr`, via `static_cast`
5791debfc3dSmrg template<typename _Tp, typename _Up>
5801debfc3dSmrg inline shared_ptr<_Tp>
5811debfc3dSmrg static_pointer_cast(const shared_ptr<_Up>& __r) noexcept
5821debfc3dSmrg {
5831debfc3dSmrg using _Sp = shared_ptr<_Tp>;
5841debfc3dSmrg return _Sp(__r, static_cast<typename _Sp::element_type*>(__r.get()));
5851debfc3dSmrg }
5861debfc3dSmrg
587*8feb0f0bSmrg /// Convert type of `shared_ptr`, via `const_cast`
5881debfc3dSmrg template<typename _Tp, typename _Up>
5891debfc3dSmrg inline shared_ptr<_Tp>
5901debfc3dSmrg const_pointer_cast(const shared_ptr<_Up>& __r) noexcept
5911debfc3dSmrg {
5921debfc3dSmrg using _Sp = shared_ptr<_Tp>;
5931debfc3dSmrg return _Sp(__r, const_cast<typename _Sp::element_type*>(__r.get()));
5941debfc3dSmrg }
5951debfc3dSmrg
596*8feb0f0bSmrg /// Convert type of `shared_ptr`, via `dynamic_cast`
5971debfc3dSmrg template<typename _Tp, typename _Up>
5981debfc3dSmrg inline shared_ptr<_Tp>
5991debfc3dSmrg dynamic_pointer_cast(const shared_ptr<_Up>& __r) noexcept
6001debfc3dSmrg {
6011debfc3dSmrg using _Sp = shared_ptr<_Tp>;
6021debfc3dSmrg if (auto* __p = dynamic_cast<typename _Sp::element_type*>(__r.get()))
6031debfc3dSmrg return _Sp(__r, __p);
6041debfc3dSmrg return _Sp();
6051debfc3dSmrg }
6061debfc3dSmrg
607*8feb0f0bSmrg #if __cplusplus >= 201703L
608*8feb0f0bSmrg /// Convert type of `shared_ptr`, via `reinterpret_cast`
6091debfc3dSmrg template<typename _Tp, typename _Up>
6101debfc3dSmrg inline shared_ptr<_Tp>
6111debfc3dSmrg reinterpret_pointer_cast(const shared_ptr<_Up>& __r) noexcept
6121debfc3dSmrg {
6131debfc3dSmrg using _Sp = shared_ptr<_Tp>;
6141debfc3dSmrg return _Sp(__r, reinterpret_cast<typename _Sp::element_type*>(__r.get()));
6151debfc3dSmrg }
616*8feb0f0bSmrg
617*8feb0f0bSmrg #if __cplusplus > 201703L
618*8feb0f0bSmrg // _GLIBCXX_RESOLVE_LIB_DEFECTS
619*8feb0f0bSmrg // 2996. Missing rvalue overloads for shared_ptr operations
620*8feb0f0bSmrg
621*8feb0f0bSmrg /// Convert type of `shared_ptr` rvalue, via `static_cast`
622*8feb0f0bSmrg template<typename _Tp, typename _Up>
623*8feb0f0bSmrg inline shared_ptr<_Tp>
624*8feb0f0bSmrg static_pointer_cast(shared_ptr<_Up>&& __r) noexcept
625*8feb0f0bSmrg {
626*8feb0f0bSmrg using _Sp = shared_ptr<_Tp>;
627*8feb0f0bSmrg return _Sp(std::move(__r),
628*8feb0f0bSmrg static_cast<typename _Sp::element_type*>(__r.get()));
629*8feb0f0bSmrg }
630*8feb0f0bSmrg
631*8feb0f0bSmrg /// Convert type of `shared_ptr` rvalue, via `const_cast`
632*8feb0f0bSmrg template<typename _Tp, typename _Up>
633*8feb0f0bSmrg inline shared_ptr<_Tp>
634*8feb0f0bSmrg const_pointer_cast(shared_ptr<_Up>&& __r) noexcept
635*8feb0f0bSmrg {
636*8feb0f0bSmrg using _Sp = shared_ptr<_Tp>;
637*8feb0f0bSmrg return _Sp(std::move(__r),
638*8feb0f0bSmrg const_cast<typename _Sp::element_type*>(__r.get()));
639*8feb0f0bSmrg }
640*8feb0f0bSmrg
641*8feb0f0bSmrg /// Convert type of `shared_ptr` rvalue, via `dynamic_cast`
642*8feb0f0bSmrg template<typename _Tp, typename _Up>
643*8feb0f0bSmrg inline shared_ptr<_Tp>
644*8feb0f0bSmrg dynamic_pointer_cast(shared_ptr<_Up>&& __r) noexcept
645*8feb0f0bSmrg {
646*8feb0f0bSmrg using _Sp = shared_ptr<_Tp>;
647*8feb0f0bSmrg if (auto* __p = dynamic_cast<typename _Sp::element_type*>(__r.get()))
648*8feb0f0bSmrg return _Sp(std::move(__r), __p);
649*8feb0f0bSmrg return _Sp();
650*8feb0f0bSmrg }
651*8feb0f0bSmrg
652*8feb0f0bSmrg /// Convert type of `shared_ptr` rvalue, via `reinterpret_cast`
653*8feb0f0bSmrg template<typename _Tp, typename _Up>
654*8feb0f0bSmrg inline shared_ptr<_Tp>
655*8feb0f0bSmrg reinterpret_pointer_cast(shared_ptr<_Up>&& __r) noexcept
656*8feb0f0bSmrg {
657*8feb0f0bSmrg using _Sp = shared_ptr<_Tp>;
658*8feb0f0bSmrg return _Sp(std::move(__r),
659*8feb0f0bSmrg reinterpret_cast<typename _Sp::element_type*>(__r.get()));
660*8feb0f0bSmrg }
661*8feb0f0bSmrg #endif // C++20
662*8feb0f0bSmrg #endif // C++17
663*8feb0f0bSmrg
664*8feb0f0bSmrg /// @}
6651debfc3dSmrg
6661debfc3dSmrg /**
667*8feb0f0bSmrg * @brief A non-owning observer for a pointer owned by a shared_ptr
6681debfc3dSmrg *
669*8feb0f0bSmrg * A weak_ptr provides a safe alternative to a raw pointer when you want
670*8feb0f0bSmrg * a non-owning reference to an object that is managed by a shared_ptr.
671*8feb0f0bSmrg *
672*8feb0f0bSmrg * Unlike a raw pointer, a weak_ptr can be converted to a new shared_ptr
673*8feb0f0bSmrg * that shares ownership with every other shared_ptr that already owns
674*8feb0f0bSmrg * the pointer. In other words you can upgrade from a non-owning "weak"
675*8feb0f0bSmrg * reference to an owning shared_ptr, without having access to any of
676*8feb0f0bSmrg * the existing shared_ptr objects.
677*8feb0f0bSmrg *
678*8feb0f0bSmrg * Also unlike a raw pointer, a weak_ptr does not become "dangling" after
679*8feb0f0bSmrg * the object it points to has been destroyed. Instead, a weak_ptr
680*8feb0f0bSmrg * becomes _expired_ and can no longer be converted to a shared_ptr that
681*8feb0f0bSmrg * owns the freed pointer, so you cannot accidentally access the pointed-to
682*8feb0f0bSmrg * object after it has been destroyed.
6831debfc3dSmrg */
6841debfc3dSmrg template<typename _Tp>
6851debfc3dSmrg class weak_ptr : public __weak_ptr<_Tp>
6861debfc3dSmrg {
6871debfc3dSmrg template<typename _Arg>
6881debfc3dSmrg using _Constructible = typename enable_if<
6891debfc3dSmrg is_constructible<__weak_ptr<_Tp>, _Arg>::value
6901debfc3dSmrg >::type;
6911debfc3dSmrg
6921debfc3dSmrg template<typename _Arg>
6931debfc3dSmrg using _Assignable = typename enable_if<
6941debfc3dSmrg is_assignable<__weak_ptr<_Tp>&, _Arg>::value, weak_ptr&
6951debfc3dSmrg >::type;
6961debfc3dSmrg
6971debfc3dSmrg public:
6981debfc3dSmrg constexpr weak_ptr() noexcept = default;
6991debfc3dSmrg
7001debfc3dSmrg template<typename _Yp,
7011debfc3dSmrg typename = _Constructible<const shared_ptr<_Yp>&>>
7021debfc3dSmrg weak_ptr(const shared_ptr<_Yp>& __r) noexcept
7031debfc3dSmrg : __weak_ptr<_Tp>(__r) { }
7041debfc3dSmrg
7051debfc3dSmrg weak_ptr(const weak_ptr&) noexcept = default;
7061debfc3dSmrg
7071debfc3dSmrg template<typename _Yp, typename = _Constructible<const weak_ptr<_Yp>&>>
7081debfc3dSmrg weak_ptr(const weak_ptr<_Yp>& __r) noexcept
7091debfc3dSmrg : __weak_ptr<_Tp>(__r) { }
7101debfc3dSmrg
7111debfc3dSmrg weak_ptr(weak_ptr&&) noexcept = default;
7121debfc3dSmrg
7131debfc3dSmrg template<typename _Yp, typename = _Constructible<weak_ptr<_Yp>>>
7141debfc3dSmrg weak_ptr(weak_ptr<_Yp>&& __r) noexcept
7151debfc3dSmrg : __weak_ptr<_Tp>(std::move(__r)) { }
7161debfc3dSmrg
7171debfc3dSmrg weak_ptr&
7181debfc3dSmrg operator=(const weak_ptr& __r) noexcept = default;
7191debfc3dSmrg
7201debfc3dSmrg template<typename _Yp>
7211debfc3dSmrg _Assignable<const weak_ptr<_Yp>&>
7221debfc3dSmrg operator=(const weak_ptr<_Yp>& __r) noexcept
7231debfc3dSmrg {
7241debfc3dSmrg this->__weak_ptr<_Tp>::operator=(__r);
7251debfc3dSmrg return *this;
7261debfc3dSmrg }
7271debfc3dSmrg
7281debfc3dSmrg template<typename _Yp>
7291debfc3dSmrg _Assignable<const shared_ptr<_Yp>&>
7301debfc3dSmrg operator=(const shared_ptr<_Yp>& __r) noexcept
7311debfc3dSmrg {
7321debfc3dSmrg this->__weak_ptr<_Tp>::operator=(__r);
7331debfc3dSmrg return *this;
7341debfc3dSmrg }
7351debfc3dSmrg
7361debfc3dSmrg weak_ptr&
7371debfc3dSmrg operator=(weak_ptr&& __r) noexcept = default;
7381debfc3dSmrg
7391debfc3dSmrg template<typename _Yp>
7401debfc3dSmrg _Assignable<weak_ptr<_Yp>>
7411debfc3dSmrg operator=(weak_ptr<_Yp>&& __r) noexcept
7421debfc3dSmrg {
7431debfc3dSmrg this->__weak_ptr<_Tp>::operator=(std::move(__r));
7441debfc3dSmrg return *this;
7451debfc3dSmrg }
7461debfc3dSmrg
7471debfc3dSmrg shared_ptr<_Tp>
7481debfc3dSmrg lock() const noexcept
7491debfc3dSmrg { return shared_ptr<_Tp>(*this, std::nothrow); }
7501debfc3dSmrg };
7511debfc3dSmrg
7521debfc3dSmrg #if __cpp_deduction_guides >= 201606
7531debfc3dSmrg template<typename _Tp>
7541debfc3dSmrg weak_ptr(shared_ptr<_Tp>) -> weak_ptr<_Tp>;
7551debfc3dSmrg #endif
7561debfc3dSmrg
7571debfc3dSmrg // 20.7.2.3.6 weak_ptr specialized algorithms.
758*8feb0f0bSmrg /// Swap overload for weak_ptr
759*8feb0f0bSmrg /// @relates weak_ptr
7601debfc3dSmrg template<typename _Tp>
7611debfc3dSmrg inline void
7621debfc3dSmrg swap(weak_ptr<_Tp>& __a, weak_ptr<_Tp>& __b) noexcept
7631debfc3dSmrg { __a.swap(__b); }
7641debfc3dSmrg
7651debfc3dSmrg
7661debfc3dSmrg /// Primary template owner_less
7671debfc3dSmrg template<typename _Tp = void>
7681debfc3dSmrg struct owner_less;
7691debfc3dSmrg
770*8feb0f0bSmrg /// Void specialization of owner_less compares either shared_ptr or weak_ptr
7711debfc3dSmrg template<>
7721debfc3dSmrg struct owner_less<void> : _Sp_owner_less<void, void>
7731debfc3dSmrg { };
7741debfc3dSmrg
7751debfc3dSmrg /// Partial specialization of owner_less for shared_ptr.
7761debfc3dSmrg template<typename _Tp>
7771debfc3dSmrg struct owner_less<shared_ptr<_Tp>>
7781debfc3dSmrg : public _Sp_owner_less<shared_ptr<_Tp>, weak_ptr<_Tp>>
7791debfc3dSmrg { };
7801debfc3dSmrg
7811debfc3dSmrg /// Partial specialization of owner_less for weak_ptr.
7821debfc3dSmrg template<typename _Tp>
7831debfc3dSmrg struct owner_less<weak_ptr<_Tp>>
7841debfc3dSmrg : public _Sp_owner_less<weak_ptr<_Tp>, shared_ptr<_Tp>>
7851debfc3dSmrg { };
7861debfc3dSmrg
7871debfc3dSmrg /**
7881debfc3dSmrg * @brief Base class allowing use of member function shared_from_this.
7891debfc3dSmrg */
7901debfc3dSmrg template<typename _Tp>
7911debfc3dSmrg class enable_shared_from_this
7921debfc3dSmrg {
7931debfc3dSmrg protected:
7941debfc3dSmrg constexpr enable_shared_from_this() noexcept { }
7951debfc3dSmrg
7961debfc3dSmrg enable_shared_from_this(const enable_shared_from_this&) noexcept { }
7971debfc3dSmrg
7981debfc3dSmrg enable_shared_from_this&
7991debfc3dSmrg operator=(const enable_shared_from_this&) noexcept
8001debfc3dSmrg { return *this; }
8011debfc3dSmrg
8021debfc3dSmrg ~enable_shared_from_this() { }
8031debfc3dSmrg
8041debfc3dSmrg public:
8051debfc3dSmrg shared_ptr<_Tp>
8061debfc3dSmrg shared_from_this()
8071debfc3dSmrg { return shared_ptr<_Tp>(this->_M_weak_this); }
8081debfc3dSmrg
8091debfc3dSmrg shared_ptr<const _Tp>
8101debfc3dSmrg shared_from_this() const
8111debfc3dSmrg { return shared_ptr<const _Tp>(this->_M_weak_this); }
8121debfc3dSmrg
8131debfc3dSmrg #if __cplusplus > 201402L || !defined(__STRICT_ANSI__) // c++1z or gnu++11
8141debfc3dSmrg #define __cpp_lib_enable_shared_from_this 201603
8151debfc3dSmrg weak_ptr<_Tp>
8161debfc3dSmrg weak_from_this() noexcept
8171debfc3dSmrg { return this->_M_weak_this; }
8181debfc3dSmrg
8191debfc3dSmrg weak_ptr<const _Tp>
8201debfc3dSmrg weak_from_this() const noexcept
8211debfc3dSmrg { return this->_M_weak_this; }
8221debfc3dSmrg #endif
8231debfc3dSmrg
8241debfc3dSmrg private:
8251debfc3dSmrg template<typename _Tp1>
8261debfc3dSmrg void
8271debfc3dSmrg _M_weak_assign(_Tp1* __p, const __shared_count<>& __n) const noexcept
8281debfc3dSmrg { _M_weak_this._M_assign(__p, __n); }
8291debfc3dSmrg
8301debfc3dSmrg // Found by ADL when this is an associated class.
8311debfc3dSmrg friend const enable_shared_from_this*
8321debfc3dSmrg __enable_shared_from_this_base(const __shared_count<>&,
8331debfc3dSmrg const enable_shared_from_this* __p)
8341debfc3dSmrg { return __p; }
8351debfc3dSmrg
8361debfc3dSmrg template<typename, _Lock_policy>
8371debfc3dSmrg friend class __shared_ptr;
8381debfc3dSmrg
8391debfc3dSmrg mutable weak_ptr<_Tp> _M_weak_this;
8401debfc3dSmrg };
8411debfc3dSmrg
842*8feb0f0bSmrg /// @relates shared_ptr @{
843*8feb0f0bSmrg
8441debfc3dSmrg /**
8451debfc3dSmrg * @brief Create an object that is owned by a shared_ptr.
8461debfc3dSmrg * @param __a An allocator.
8471debfc3dSmrg * @param __args Arguments for the @a _Tp object's constructor.
8481debfc3dSmrg * @return A shared_ptr that owns the newly created object.
8491debfc3dSmrg * @throw An exception thrown from @a _Alloc::allocate or from the
8501debfc3dSmrg * constructor of @a _Tp.
8511debfc3dSmrg *
8521debfc3dSmrg * A copy of @a __a will be used to allocate memory for the shared_ptr
8531debfc3dSmrg * and the new object.
8541debfc3dSmrg */
8551debfc3dSmrg template<typename _Tp, typename _Alloc, typename... _Args>
8561debfc3dSmrg inline shared_ptr<_Tp>
8571debfc3dSmrg allocate_shared(const _Alloc& __a, _Args&&... __args)
8581debfc3dSmrg {
859*8feb0f0bSmrg static_assert(!is_array<_Tp>::value, "make_shared<T[]> not supported");
860*8feb0f0bSmrg
861a2dc1f3fSmrg return shared_ptr<_Tp>(_Sp_alloc_shared_tag<_Alloc>{__a},
8621debfc3dSmrg std::forward<_Args>(__args)...);
8631debfc3dSmrg }
8641debfc3dSmrg
8651debfc3dSmrg /**
8661debfc3dSmrg * @brief Create an object that is owned by a shared_ptr.
8671debfc3dSmrg * @param __args Arguments for the @a _Tp object's constructor.
8681debfc3dSmrg * @return A shared_ptr that owns the newly created object.
8691debfc3dSmrg * @throw std::bad_alloc, or an exception thrown from the
8701debfc3dSmrg * constructor of @a _Tp.
8711debfc3dSmrg */
8721debfc3dSmrg template<typename _Tp, typename... _Args>
8731debfc3dSmrg inline shared_ptr<_Tp>
8741debfc3dSmrg make_shared(_Args&&... __args)
8751debfc3dSmrg {
876a2dc1f3fSmrg typedef typename std::remove_cv<_Tp>::type _Tp_nc;
8771debfc3dSmrg return std::allocate_shared<_Tp>(std::allocator<_Tp_nc>(),
8781debfc3dSmrg std::forward<_Args>(__args)...);
8791debfc3dSmrg }
8801debfc3dSmrg
8811debfc3dSmrg /// std::hash specialization for shared_ptr.
8821debfc3dSmrg template<typename _Tp>
8831debfc3dSmrg struct hash<shared_ptr<_Tp>>
8841debfc3dSmrg : public __hash_base<size_t, shared_ptr<_Tp>>
8851debfc3dSmrg {
8861debfc3dSmrg size_t
8871debfc3dSmrg operator()(const shared_ptr<_Tp>& __s) const noexcept
8881debfc3dSmrg {
8891debfc3dSmrg return std::hash<typename shared_ptr<_Tp>::element_type*>()(__s.get());
8901debfc3dSmrg }
8911debfc3dSmrg };
8921debfc3dSmrg
893*8feb0f0bSmrg /// @} relates shared_ptr
894*8feb0f0bSmrg /// @} group pointer_abstractions
8951debfc3dSmrg
896c0a68be4Smrg #if __cplusplus >= 201703L
897c0a68be4Smrg namespace __detail::__variant
898c0a68be4Smrg {
899c0a68be4Smrg template<typename> struct _Never_valueless_alt; // see <variant>
900c0a68be4Smrg
901c0a68be4Smrg // Provide the strong exception-safety guarantee when emplacing a
902c0a68be4Smrg // shared_ptr into a variant.
903c0a68be4Smrg template<typename _Tp>
904c0a68be4Smrg struct _Never_valueless_alt<std::shared_ptr<_Tp>>
905c0a68be4Smrg : std::true_type
906c0a68be4Smrg { };
907c0a68be4Smrg
908c0a68be4Smrg // Provide the strong exception-safety guarantee when emplacing a
909c0a68be4Smrg // weak_ptr into a variant.
910c0a68be4Smrg template<typename _Tp>
911c0a68be4Smrg struct _Never_valueless_alt<std::weak_ptr<_Tp>>
912c0a68be4Smrg : std::true_type
913c0a68be4Smrg { };
914c0a68be4Smrg } // namespace __detail::__variant
915c0a68be4Smrg #endif // C++17
916c0a68be4Smrg
9171debfc3dSmrg _GLIBCXX_END_NAMESPACE_VERSION
9181debfc3dSmrg } // namespace
9191debfc3dSmrg
9201debfc3dSmrg #endif // _SHARED_PTR_H
921