[util.smartptr.shared] - C++23 → Trunk

Files changed (1) hide show

tmp/tmp_pcucx3u/{from.md → to.md} +160 -139

tmp/tmp_pcucx3u/{from.md → to.md} RENAMED Viewed

@@ -17,68 +17,73 @@ namespace std {
     // [util.smartptr.shared.const], constructors
     constexpr shared_ptr() noexcept;
     constexpr shared_ptr(nullptr_t) noexcept : shared_ptr() { }
     template<class Y>
-      explicit shared_ptr(Y* p);
     template<class Y, class D>
-      shared_ptr(Y* p, D d);
     template<class Y, class D, class A>
-      shared_ptr(Y* p, D d, A a);
     template<class D>
-      shared_ptr(nullptr_t p, D d);
     template<class D, class A>
-      shared_ptr(nullptr_t p, D d, A a);
     template<class Y>
-      shared_ptr(const shared_ptr<Y>& r, element_type* p) noexcept;
     template<class Y>
-      shared_ptr(shared_ptr<Y>&& r, element_type* p) noexcept;
-    shared_ptr(const shared_ptr& r) noexcept;
     template<class Y>
-      shared_ptr(const shared_ptr<Y>& r) noexcept;
-    shared_ptr(shared_ptr&& r) noexcept;
     template<class Y>
-      shared_ptr(shared_ptr<Y>&& r) noexcept;
     template<class Y>
-      explicit shared_ptr(const weak_ptr<Y>& r);
     template<class Y, class D>
-      shared_ptr(unique_ptr<Y, D>&& r);
     // [util.smartptr.shared.dest], destructor
-    ~shared_ptr();
     // [util.smartptr.shared.assign], assignment
-    shared_ptr& operator=(const shared_ptr& r) noexcept;
     template<class Y>
-      shared_ptr& operator=(const shared_ptr<Y>& r) noexcept;
-    shared_ptr& operator=(shared_ptr&& r) noexcept;
     template<class Y>
-      shared_ptr& operator=(shared_ptr<Y>&& r) noexcept;
     template<class Y, class D>
-      shared_ptr& operator=(unique_ptr<Y, D>&& r);
     // [util.smartptr.shared.mod], modifiers
-    void swap(shared_ptr& r) noexcept;
-    void reset() noexcept;
     template<class Y>
-      void reset(Y* p);
     template<class Y, class D>
-      void reset(Y* p, D d);
     template<class Y, class D, class A>
-      void reset(Y* p, D d, A a);
     // [util.smartptr.shared.obs], observers
-    element_type* get() const noexcept;
-    T& operator*() const noexcept;
-    T* operator->() const noexcept;
-    element_type& operator[](ptrdiff_t i) const;
-    long use_count() const noexcept;
-    explicit operator bool() const noexcept;
     template<class U>
-      bool owner_before(const shared_ptr<U>& b) const noexcept;
     template<class U>
-      bool owner_before(const weak_ptr<U>& b) const noexcept;
   };
   template<class T>
     shared_ptr(weak_ptr<T>) -> shared_ptr<T>;
   template<class T, class D>
@@ -110,13 +115,13 @@ For purposes of determining the presence of a data race, member
 functions shall access and modify only the `shared_ptr` and `weak_ptr`
 objects themselves and not objects they refer to. Changes in
 `use_count()` do not reflect modifications that can introduce data
 races.
-For the purposes of subclause [[smartptr]], a pointer type `Y*` is said
-to be *compatible with* a pointer type `T*` when either `Y*` is
-convertible to `T*` or `Y` is `U[N]` and `T` is cv `U[]`.
 ##### Constructors <a id="util.smartptr.shared.const">[[util.smartptr.shared.const]]</a>
 In the constructor definitions below, enables `shared_from_this` with
 `p`, for a pointer `p` of type `Y*`, means that if `Y` has an
@@ -124,26 +129,26 @@ unambiguous and accessible base class that is a specialization of
 `enable_shared_from_this` [[util.smartptr.enab]], then `remove_cv_t<Y>*`
 shall be implicitly convertible to `T*` and the constructor evaluates
 the statement:
 ``` cpp
-if (p != nullptr && p->weak_this.expired())
-  p->weak_this = shared_ptr<remove_cv_t<Y>>(*this, const_cast<remove_cv_t<Y>*>(p));
 ```
-The assignment to the `weak_this` member is not atomic and conflicts
 with any potentially concurrent access to the same object
 [[intro.multithread]].
 ``` cpp
 constexpr shared_ptr() noexcept;
 ```
 *Ensures:* `use_count() == 0 && get() == nullptr`.
 ``` cpp
-template<class Y> explicit shared_ptr(Y* p);
 ```
 *Constraints:* When `T` is an array type, the expression `delete[] p` is
 well-formed and either `T` is `U[N]` and `Y(*)[N]` is convertible to
 `T*`, or `T` is `U[]` and `Y(*)[]` is convertible to `T*`. When `T` is
@@ -167,14 +172,14 @@ not an array type, `delete[] p` otherwise.
 *Throws:* `bad_alloc`, or an *implementation-defined* exception when a
 resource other than memory cannot be obtained.
 ``` cpp
-template<class Y, class D> shared_ptr(Y* p, D d);
-template<class Y, class D, class A> shared_ptr(Y* p, D d, A a);
-template<class D> shared_ptr(nullptr_t p, D d);
-template<class D, class A> shared_ptr(nullptr_t p, D d, A a);
 ```
 *Constraints:* `is_move_constructible_v<D>` is `true`, and `d(p)` is a
 well-formed expression. For the first two overloads:
@@ -199,12 +204,12 @@ use. If an exception is thrown, `d(p)` is called.
 *Throws:* `bad_alloc`, or an *implementation-defined* exception when a
 resource other than memory cannot be obtained.
 ``` cpp
-template<class Y> shared_ptr(const shared_ptr<Y>& r, element_type* p) noexcept;
-template<class Y> shared_ptr(shared_ptr<Y>&& r, element_type* p) noexcept;
 ```
 *Effects:* Constructs a `shared_ptr` instance that stores `p` and shares
 ownership with the initial value of `r`.
@@ -217,12 +222,12 @@ destroyed. — *end note*]
 [*Note 2*: This constructor allows creation of an empty `shared_ptr`
 instance with a non-null stored pointer. — *end note*]
 ``` cpp
-shared_ptr(const shared_ptr& r) noexcept;
-template<class Y> shared_ptr(const shared_ptr<Y>& r) noexcept;
 ```
 *Constraints:* For the second constructor, `Y*` is compatible with `T*`.
 *Effects:* If `r` is empty, constructs an empty `shared_ptr` object;
@@ -230,23 +235,23 @@ otherwise, constructs a `shared_ptr` object that shares ownership with
 `r`.
 *Ensures:* `get() == r.get() && use_count() == r.use_count()`.
 ``` cpp
-shared_ptr(shared_ptr&& r) noexcept;
-template<class Y> shared_ptr(shared_ptr<Y>&& r) noexcept;
 ```
 *Constraints:* For the second constructor, `Y*` is compatible with `T*`.
 *Effects:* Move constructs a `shared_ptr` instance from `r`.
 *Ensures:* `*this` contains the old value of `r`. `r` is empty, and
 `r.get() == nullptr`.
 ``` cpp
-template<class Y> explicit shared_ptr(const weak_ptr<Y>& r);
 ```
 *Constraints:* `Y*` is compatible with `T*`.
 *Effects:* Constructs a `shared_ptr` object that shares ownership with
@@ -256,11 +261,11 @@ thrown, the constructor has no effect.
 *Ensures:* `use_count() == r.use_count()`.
 *Throws:* `bad_weak_ptr` when `r.expired()`.
 ``` cpp
-template<class Y, class D> shared_ptr(unique_ptr<Y, D>&& r);
 ```
 *Constraints:* `Y*` is compatible with `T*` and
 `unique_ptr<Y, D>::pointer` is convertible to `element_type*`.
@@ -271,11 +276,11 @@ equivalent to `shared_ptr(r.release(), ref(r.get_deleter()))`. If an
 exception is thrown, the constructor has no effect.
 ##### Destructor <a id="util.smartptr.shared.dest">[[util.smartptr.shared.dest]]</a>
 ``` cpp
-~shared_ptr();
 ```
 *Effects:*
 - If `*this` is empty or shares ownership with another `shared_ptr`
@@ -291,12 +296,12 @@ been destroyed all `shared_ptr` instances that shared ownership with
 value. — *end note*]
 ##### Assignment <a id="util.smartptr.shared.assign">[[util.smartptr.shared.assign]]</a>
 ``` cpp
-shared_ptr& operator=(const shared_ptr& r) noexcept;
-template<class Y> shared_ptr& operator=(const shared_ptr<Y>& r) noexcept;
 ```
 *Effects:* Equivalent to `shared_ptr(r).swap(*this)`.
 *Returns:* `*this`.
@@ -318,68 +323,68 @@ q = p;
 both assignments can be no-ops.
 — *end note*]
 ``` cpp
-shared_ptr& operator=(shared_ptr&& r) noexcept;
-template<class Y> shared_ptr& operator=(shared_ptr<Y>&& r) noexcept;
 ```
 *Effects:* Equivalent to `shared_ptr(std::move(r)).swap(*this)`.
 *Returns:* `*this`.
 ``` cpp
-template<class Y, class D> shared_ptr& operator=(unique_ptr<Y, D>&& r);
 ```
 *Effects:* Equivalent to `shared_ptr(std::move(r)).swap(*this)`.
 *Returns:* `*this`.
 ##### Modifiers <a id="util.smartptr.shared.mod">[[util.smartptr.shared.mod]]</a>
 ``` cpp
-void swap(shared_ptr& r) noexcept;
 ```
 *Effects:* Exchanges the contents of `*this` and `r`.
 ``` cpp
-void reset() noexcept;
 ```
 *Effects:* Equivalent to `shared_ptr().swap(*this)`.
 ``` cpp
-template<class Y> void reset(Y* p);
 ```
 *Effects:* Equivalent to `shared_ptr(p).swap(*this)`.
 ``` cpp
-template<class Y, class D> void reset(Y* p, D d);
 ```
 *Effects:* Equivalent to `shared_ptr(p, d).swap(*this)`.
 ``` cpp
-template<class Y, class D, class A> void reset(Y* p, D d, A a);
 ```
 *Effects:* Equivalent to `shared_ptr(p, d, a).swap(*this)`.
 ##### Observers <a id="util.smartptr.shared.obs">[[util.smartptr.shared.obs]]</a>
 ``` cpp
-element_type* get() const noexcept;
 ```
 *Returns:* The stored pointer.
 ``` cpp
-T& operator*() const noexcept;
 ```
 *Preconditions:* `get() != nullptr`.
 *Returns:* `*get()`.
@@ -389,11 +394,11 @@ whether this member function is declared. If it is declared, it is
 unspecified what its return type is, except that the declaration
 (although not necessarily the definition) of the function shall be
 well-formed.
 ``` cpp
-T* operator->() const noexcept;
 ```
 *Preconditions:* `get() != nullptr`.
 *Returns:* `get()`.
@@ -402,15 +407,16 @@ T* operator->() const noexcept;
 member function is declared. If it is declared, it is unspecified what
 its return type is, except that the declaration (although not
 necessarily the definition) of the function shall be well-formed.
 ``` cpp
-element_type& operator[](ptrdiff_t i) const;
 ```
-*Preconditions:* `get() != nullptr && i >= 0`. If `T` is `U[N]`,
-`i < N`.
 *Returns:* `get()[i]`.
 *Throws:* Nothing.
@@ -418,11 +424,11 @@ element_type& operator[](ptrdiff_t i) const;
 member function is declared. If it is declared, it is unspecified what
 its return type is, except that the declaration (although not
 necessarily the definition) of the function shall be well-formed.
 ``` cpp
-long use_count() const noexcept;
 ```
 *Synchronization:* None.
 *Returns:* The number of `shared_ptr` objects, `*this` included, that
@@ -438,45 +444,62 @@ share ownership with `*this`, or `0` when `*this` is empty.
 `use_count()`, the result is approximate. In particular,
 `use_count() == 1` does not imply that accesses through a previously
 destroyed `shared_ptr` have in any sense completed. — *end note*]
 ``` cpp
-explicit operator bool() const noexcept;
 ```
 *Returns:* `get() != nullptr`.
 ``` cpp
-template<class U> bool owner_before(const shared_ptr<U>& b) const noexcept;
-template<class U> bool owner_before(const weak_ptr<U>& b) const noexcept;
 ```
 *Returns:* An unspecified value such that
-- `x.owner_before(y)` defines a strict weak ordering as defined
   in  [[alg.sorting]];
-- under the equivalence relation defined by `owner_before`,
-  `!a.owner_before(b) && !b.owner_before(a)`, two `shared_ptr` or
-  `weak_ptr` instances are equivalent if and only if they share
-  ownership or are both empty.
 ##### Creation <a id="util.smartptr.shared.create">[[util.smartptr.shared.create]]</a>
 The common requirements that apply to all `make_shared`,
 `allocate_shared`, `make_shared_for_overwrite`, and
 `allocate_shared_for_overwrite` overloads, unless specified otherwise,
 are described below.
 ``` cpp
 template<class T, ...>
-  shared_ptr<T> make_shared(args);
 template<class T, class A, ...>
-  shared_ptr<T> allocate_shared(const A& a, args);
 template<class T, ...>
-  shared_ptr<T> make_shared_for_overwrite(args);
 template<class T, class A, ...>
-  shared_ptr<T> allocate_shared_for_overwrite(const A& a, args);
 ```
 *Preconditions:* `A` meets the *Cpp17Allocator*
 requirements [[allocator.requirements.general]].
@@ -517,56 +540,58 @@ the initialization of the object.
   suitable to hold an object of type `U`.
 - When a (sub)object of a non-array type `U` is specified to have an
   initial value of `v`, or `U(l...)`, where `l...` is a list of
   constructor arguments, `allocate_shared` shall initialize this
   (sub)object via the expression
-  - `allocator_traits<A2>::construct(a2, pv, v)` or
-  - `allocator_traits<A2>::construct(a2, pv, l...)`
-  respectively, where `pv` points to storage suitable to hold an object
- of type `U` and `a2` of type `A2` is a rebound copy of the allocator
-  `a` passed to `allocate_shared` such that its `value_type` is
-  `remove_cv_t<U>`.
 - When a (sub)object of non-array type `U` is specified to have a
   default initial value, `make_shared` shall initialize this (sub)object
   via the expression `::new(pv) U()`, where `pv` has type `void*` and
   points to storage suitable to hold an object of type `U`.
 - When a (sub)object of non-array type `U` is specified to have a
-  default initial value, `allocate_shared` shall initialize this
- (sub)object via the expression
-  `allocator_traits<A2>::construct(a2, pv)`, where `pv` points to
- storage suitable to hold an object of type `U` and `a2` of type `A2`
-  is a rebound copy of the allocator `a` passed to `allocate_shared`
- such that its `value_type` is `remove_cv_t<U>`.
 - When a (sub)object of non-array type `U` is initialized by
   `make_shared_for_overwrite` or `allocate_shared_for_overwrite`, it is
   initialized via the expression `::new(pv) U`, where `pv` has type
   `void*` and points to storage suitable to hold an object of type `U`.
 - Array elements are initialized in ascending order of their addresses.
 - When the lifetime of the object managed by the return value ends, or
   when the initialization of an array element throws an exception, the
   initialized elements are destroyed in the reverse order of their
   original construction.
 - When a (sub)object of non-array type `U` that was initialized by
-  `make_shared` is to be destroyed, it is destroyed via the expression
-  `pv->~U()` where `pv` points to that object of type `U`.
 - When a (sub)object of non-array type `U` that was initialized by
   `allocate_shared` is to be destroyed, it is destroyed via the
-  expression `allocator_traits<A2>::destroy(a2, pv)` where `pv` points
- to that object of type `remove_cv_t<U>` and `a2` of type `A2` is a
- rebound copy of the allocator `a` passed to `allocate_shared` such
- that its `value_type` is `remove_cv_t<U>`.
 [*Note 7*: These functions will typically allocate more memory than
 `sizeof(T)` to allow for internal bookkeeping structures such as
 reference counts. — *end note*]
 ``` cpp
 template<class T, class... Args>
-  shared_ptr<T> make_shared(Args&&... args);                    // T is not array
 template<class T, class A, class... Args>
-  shared_ptr<T> allocate_shared(const A& a, Args&&... args);    // T is not array
 ```
 *Constraints:* `T` is not an array type.
 *Returns:* A `shared_ptr` to an object of type `T` with an initial value
@@ -585,14 +610,14 @@ shared_ptr<vector<int>> q = make_shared<vector<int>>(16, 1);
 ```
 — *end example*]
 ``` cpp
-template<class T> shared_ptr<T>
-  make_shared(size_t N); // T is U[]
 template<class T, class A>
-  shared_ptr<T> allocate_shared(const A& a, size_t N);          // T is U[]
 ```
 *Constraints:* `T` is of the form `U[]`.
 *Returns:* A `shared_ptr` to an object of type `U[N]` with a default
@@ -609,13 +634,13 @@ shared_ptr<double[][2][2]> q = make_shared<double[][2][2]>(6);
 — *end example*]
 ``` cpp
 template<class T>
-  shared_ptr<T> make_shared();                                  // T is U[N]
 template<class T, class A>
-  shared_ptr<T> allocate_shared(const A& a);                    // T is U[N]
 ```
 *Constraints:* `T` is of the form `U[N]`.
 *Returns:* A `shared_ptr` to an object of type `T` with a default
@@ -632,14 +657,14 @@ shared_ptr<double[6][2][2]> q = make_shared<double[6][2][2]>();
 — *end example*]
 ``` cpp
 template<class T>
-  shared_ptr<T> make_shared(size_t N,
                                       const remove_extent_t<T>& u);     // T is U[]
 template<class T, class A>
-  shared_ptr<T> allocate_shared(const A& a, size_t N,
                                           const remove_extent_t<T>& u); // T is U[]
 ```
 *Constraints:* `T` is of the form `U[]`.
@@ -659,13 +684,13 @@ shared_ptr<vector<int>[]> r = make_shared<vector<int>[]>(4, {1, 2});
 — *end example*]
 ``` cpp
 template<class T>
-  shared_ptr<T> make_shared(const remove_extent_t<T>& u);       // T is U[N]
 template<class T, class A>
-  shared_ptr<T> allocate_shared(const A& a,
                                           const remove_extent_t<T>& u);   // T is U[N]
 ```
 *Constraints:* `T` is of the form `U[N]`.
@@ -685,13 +710,13 @@ shared_ptr<vector<int>[4]> r = make_shared<vector<int>[4]>({1, 2});
 — *end example*]
 ``` cpp
 template<class T>
-  shared_ptr<T> make_shared_for_overwrite();
 template<class T, class A>
-  shared_ptr<T> allocate_shared_for_overwrite(const A& a);
 ```
 *Constraints:* `T` is not an array of unknown bound.
 *Returns:* A `shared_ptr` to an object of type `T`.
@@ -709,13 +734,13 @@ shared_ptr<double[1024]> q = make_shared_for_overwrite<double[1024]>();
 — *end example*]
 ``` cpp
 template<class T>
-  shared_ptr<T> make_shared_for_overwrite(size_t N);
 template<class T, class A>
-  shared_ptr<T> allocate_shared_for_overwrite(const A& a, size_t N);
 ```
 *Constraints:* `T` is an array of unknown bound.
 *Returns:* A `shared_ptr` to an object of type `U[N]`, where `U` is
@@ -732,59 +757,59 @@ shared_ptr<double[]> p = make_shared_for_overwrite<double[]>(1024);
 ##### Comparison <a id="util.smartptr.shared.cmp">[[util.smartptr.shared.cmp]]</a>
 ``` cpp
 template<class T, class U>
-  bool operator==(const shared_ptr<T>& a, const shared_ptr<U>& b) noexcept;
 ```
 *Returns:* `a.get() == b.get()`.
 ``` cpp
 template<class T>
-  bool operator==(const shared_ptr<T>& a, nullptr_t) noexcept;
 ```
 *Returns:* `!a`.
 ``` cpp
 template<class T, class U>
-  strong_ordering operator<=>(const shared_ptr<T>& a, const shared_ptr<U>& b) noexcept;
 ```
 *Returns:* `compare_three_way()(a.get(), b.get())`.
 [*Note 8*: Defining a comparison operator function allows `shared_ptr`
 objects to be used as keys in associative containers. — *end note*]
 ``` cpp
 template<class T>
-  strong_ordering operator<=>(const shared_ptr<T>& a, nullptr_t) noexcept;
 ```
 *Returns:*
 ``` cpp
-compare_three_way()(a.get(), static_cast<typename shared_ptr<T>::element_type*>(nullptr).
 ```
 ##### Specialized algorithms <a id="util.smartptr.shared.spec">[[util.smartptr.shared.spec]]</a>
 ``` cpp
 template<class T>
-  void swap(shared_ptr<T>& a, shared_ptr<T>& b) noexcept;
 ```
 *Effects:* Equivalent to `a.swap(b)`.
 ##### Casts <a id="util.smartptr.shared.cast">[[util.smartptr.shared.cast]]</a>
 ``` cpp
 template<class T, class U>
-  shared_ptr<T> static_pointer_cast(const shared_ptr<U>& r) noexcept;
 template<class T, class U>
-  shared_ptr<T> static_pointer_cast(shared_ptr<U>&& r) noexcept;
 ```
 *Mandates:* The expression `static_cast<T*>((U*)nullptr)` is
 well-formed.
@@ -796,19 +821,18 @@ shared_ptr<T>(R, static_cast<typename shared_ptr<T>::element_type*>(r.get()))
 where *`R`* is `r` for the first overload, and `std::move(r)` for the
 second.
 [*Note 9*: The seemingly equivalent expression
-`shared_ptr<T>(static_cast<T*>(r.get()))` will eventually result in
-undefined behavior, attempting to delete the same object
-twice. — *end note*]
 ``` cpp
 template<class T, class U>
-  shared_ptr<T> dynamic_pointer_cast(const shared_ptr<U>& r) noexcept;
 template<class T, class U>
-  shared_ptr<T> dynamic_pointer_cast(shared_ptr<U>&& r) noexcept;
 ```
 *Mandates:* The expression `dynamic_cast<T*>((U*)nullptr)` is
 well-formed. The expression
 `dynamic_cast<typename shared_ptr<T>::element_type*>(r.get())` is
@@ -824,19 +848,18 @@ well-defined behavior.
   returns a non-null value `p`, `shared_ptr<T>(`*`R`*`, p)`, where *`R`*
   is `r` for the first overload, and `std::move(r)` for the second.
 - Otherwise, `shared_ptr<T>()`.
 [*Note 10*: The seemingly equivalent expression
-`shared_ptr<T>(dynamic_cast<T*>(r.get()))` will eventually result in
-undefined behavior, attempting to delete the same object
-twice. — *end note*]
 ``` cpp
 template<class T, class U>
-  shared_ptr<T> const_pointer_cast(const shared_ptr<U>& r) noexcept;
 template<class T, class U>
-  shared_ptr<T> const_pointer_cast(shared_ptr<U>&& r) noexcept;
 ```
 *Mandates:* The expression `const_cast<T*>((U*)nullptr)` is well-formed.
 *Returns:*
@@ -847,13 +870,12 @@ shared_ptr<T>(R, const_cast<typename shared_ptr<T>::element_type*>(r.get()))
 where *`R`* is `r` for the first overload, and `std::move(r)` for the
 second.
 [*Note 11*: The seemingly equivalent expression
-`shared_ptr<T>(const_cast<T*>(r.get()))` will eventually result in
-undefined behavior, attempting to delete the same object
-twice. — *end note*]
 ``` cpp
 template<class T, class U>
   shared_ptr<T> reinterpret_pointer_cast(const shared_ptr<U>& r) noexcept;
 template<class T, class U>
@@ -871,19 +893,18 @@ shared_ptr<T>(R, reinterpret_cast<typename shared_ptr<T>::element_type*>(r.get()
 where *`R`* is `r` for the first overload, and `std::move(r)` for the
 second.
 [*Note 12*: The seemingly equivalent expression
-`shared_ptr<T>(reinterpret_cast<T*>(r.get()))` will eventually result in
-undefined behavior, attempting to delete the same object
-twice. — *end note*]
 ##### `get_deleter` <a id="util.smartptr.getdeleter">[[util.smartptr.getdeleter]]</a>
 ``` cpp
 template<class D, class T>
-  D* get_deleter(const shared_ptr<T>& p) noexcept;
 ```
 *Returns:* If `p` owns a deleter `d` of type cv-unqualified `D`, returns
 `addressof(d)`; otherwise returns `nullptr`. The returned pointer
 remains valid as long as there exists a `shared_ptr` instance that owns

     // [util.smartptr.shared.const], constructors
     constexpr shared_ptr() noexcept;
     constexpr shared_ptr(nullptr_t) noexcept : shared_ptr() { }
     template<class Y>
+ constexpr explicit shared_ptr(Y* p);
     template<class Y, class D>
+ constexpr shared_ptr(Y* p, D d);
     template<class Y, class D, class A>
+ constexpr shared_ptr(Y* p, D d, A a);
     template<class D>
+ constexpr shared_ptr(nullptr_t p, D d);
     template<class D, class A>
+ constexpr shared_ptr(nullptr_t p, D d, A a);
     template<class Y>
+ constexpr shared_ptr(const shared_ptr<Y>& r, element_type* p) noexcept;
     template<class Y>
+ constexpr shared_ptr(shared_ptr<Y>&& r, element_type* p) noexcept;
+ constexpr shared_ptr(const shared_ptr& r) noexcept;
     template<class Y>
+ constexpr shared_ptr(const shared_ptr<Y>& r) noexcept;
+ constexpr shared_ptr(shared_ptr&& r) noexcept;
     template<class Y>
+ constexpr shared_ptr(shared_ptr<Y>&& r) noexcept;
     template<class Y>
+ constexpr explicit shared_ptr(const weak_ptr<Y>& r);
     template<class Y, class D>
+ constexpr shared_ptr(unique_ptr<Y, D>&& r);
     // [util.smartptr.shared.dest], destructor
+ constexpr ~shared_ptr();
     // [util.smartptr.shared.assign], assignment
+ constexpr shared_ptr& operator=(const shared_ptr& r) noexcept;
     template<class Y>
+ constexpr shared_ptr& operator=(const shared_ptr<Y>& r) noexcept;
+ constexpr shared_ptr& operator=(shared_ptr&& r) noexcept;
     template<class Y>
+ constexpr shared_ptr& operator=(shared_ptr<Y>&& r) noexcept;
     template<class Y, class D>
+ constexpr shared_ptr& operator=(unique_ptr<Y, D>&& r);
     // [util.smartptr.shared.mod], modifiers
+ constexpr void swap(shared_ptr& r) noexcept;
+ constexpr void reset() noexcept;
     template<class Y>
+ constexpr void reset(Y* p);
     template<class Y, class D>
+ constexpr void reset(Y* p, D d);
     template<class Y, class D, class A>
+ constexpr void reset(Y* p, D d, A a);
     // [util.smartptr.shared.obs], observers
+ constexpr element_type* get() const noexcept;
+ constexpr T& operator*() const noexcept;
+ constexpr T* operator->() const noexcept;
+ constexpr element_type& operator[](ptrdiff_t i) const;
+ constexpr long use_count() const noexcept;
+ constexpr explicit operator bool() const noexcept;
     template<class U>
+ constexpr bool owner_before(const shared_ptr<U>& b) const noexcept;
     template<class U>
+ constexpr bool owner_before(const weak_ptr<U>& b) const noexcept;
+    size_t owner_hash() const noexcept;
+    template<class U>
+      constexpr bool owner_equal(const shared_ptr<U>& b) const noexcept;
+    template<class U>
+      constexpr bool owner_equal(const weak_ptr<U>& b) const noexcept;
   };
   template<class T>
     shared_ptr(weak_ptr<T>) -> shared_ptr<T>;
   template<class T, class D>
 functions shall access and modify only the `shared_ptr` and `weak_ptr`
 objects themselves and not objects they refer to. Changes in
 `use_count()` do not reflect modifications that can introduce data
 races.
+For the purposes of [[smartptr]], a pointer type `Y*` is said to be
+*compatible with* a pointer type `T*` when either `Y*` is convertible to
+`T*` or `Y` is `U[N]` and `T` is cv `U[]`.
 ##### Constructors <a id="util.smartptr.shared.const">[[util.smartptr.shared.const]]</a>
 In the constructor definitions below, enables `shared_from_this` with
 `p`, for a pointer `p` of type `Y*`, means that if `Y` has an
 `enable_shared_from_this` [[util.smartptr.enab]], then `remove_cv_t<Y>*`
 shall be implicitly convertible to `T*` and the constructor evaluates
 the statement:
 ``` cpp
+if (p != nullptr && p->weak-this.expired())
+  p->weak-this = shared_ptr<remove_cv_t<Y>>(*this, const_cast<remove_cv_t<Y>*>(p));
 ```
+The assignment to the *`weak-this`* member is not atomic and conflicts
 with any potentially concurrent access to the same object
 [[intro.multithread]].
 ``` cpp
 constexpr shared_ptr() noexcept;
 ```
 *Ensures:* `use_count() == 0 && get() == nullptr`.
 ``` cpp
+template<class Y> constexpr explicit shared_ptr(Y* p);
 ```
 *Constraints:* When `T` is an array type, the expression `delete[] p` is
 well-formed and either `T` is `U[N]` and `Y(*)[N]` is convertible to
 `T*`, or `T` is `U[]` and `Y(*)[]` is convertible to `T*`. When `T` is
 *Throws:* `bad_alloc`, or an *implementation-defined* exception when a
 resource other than memory cannot be obtained.
 ``` cpp
+template<class Y, class D> constexpr shared_ptr(Y* p, D d);
+template<class Y, class D, class A> constexpr shared_ptr(Y* p, D d, A a);
+template<class D> constexpr shared_ptr(nullptr_t p, D d);
+template<class D, class A> constexpr shared_ptr(nullptr_t p, D d, A a);
 ```
 *Constraints:* `is_move_constructible_v<D>` is `true`, and `d(p)` is a
 well-formed expression. For the first two overloads:
 *Throws:* `bad_alloc`, or an *implementation-defined* exception when a
 resource other than memory cannot be obtained.
 ``` cpp
+template<class Y> constexpr shared_ptr(const shared_ptr<Y>& r, element_type* p) noexcept;
+template<class Y> constexpr shared_ptr(shared_ptr<Y>&& r, element_type* p) noexcept;
 ```
 *Effects:* Constructs a `shared_ptr` instance that stores `p` and shares
 ownership with the initial value of `r`.
 [*Note 2*: This constructor allows creation of an empty `shared_ptr`
 instance with a non-null stored pointer. — *end note*]
 ``` cpp
+constexpr shared_ptr(const shared_ptr& r) noexcept;
+template<class Y> constexpr shared_ptr(const shared_ptr<Y>& r) noexcept;
 ```
 *Constraints:* For the second constructor, `Y*` is compatible with `T*`.
 *Effects:* If `r` is empty, constructs an empty `shared_ptr` object;
 `r`.
 *Ensures:* `get() == r.get() && use_count() == r.use_count()`.
 ``` cpp
+constexpr shared_ptr(shared_ptr&& r) noexcept;
+template<class Y> constexpr shared_ptr(shared_ptr<Y>&& r) noexcept;
 ```
 *Constraints:* For the second constructor, `Y*` is compatible with `T*`.
 *Effects:* Move constructs a `shared_ptr` instance from `r`.
 *Ensures:* `*this` contains the old value of `r`. `r` is empty, and
 `r.get() == nullptr`.
 ``` cpp
+template<class Y> constexpr explicit shared_ptr(const weak_ptr<Y>& r);
 ```
 *Constraints:* `Y*` is compatible with `T*`.
 *Effects:* Constructs a `shared_ptr` object that shares ownership with
 *Ensures:* `use_count() == r.use_count()`.
 *Throws:* `bad_weak_ptr` when `r.expired()`.
 ``` cpp
+template<class Y, class D> constexpr shared_ptr(unique_ptr<Y, D>&& r);
 ```
 *Constraints:* `Y*` is compatible with `T*` and
 `unique_ptr<Y, D>::pointer` is convertible to `element_type*`.
 exception is thrown, the constructor has no effect.
 ##### Destructor <a id="util.smartptr.shared.dest">[[util.smartptr.shared.dest]]</a>
 ``` cpp
+constexpr ~shared_ptr();
 ```
 *Effects:*
 - If `*this` is empty or shares ownership with another `shared_ptr`
 value. — *end note*]
 ##### Assignment <a id="util.smartptr.shared.assign">[[util.smartptr.shared.assign]]</a>
 ``` cpp
+constexpr shared_ptr& operator=(const shared_ptr& r) noexcept;
+template<class Y> constexpr shared_ptr& operator=(const shared_ptr<Y>& r) noexcept;
 ```
 *Effects:* Equivalent to `shared_ptr(r).swap(*this)`.
 *Returns:* `*this`.
 both assignments can be no-ops.
 — *end note*]
 ``` cpp
+constexpr shared_ptr& operator=(shared_ptr&& r) noexcept;
+template<class Y> constexpr shared_ptr& operator=(shared_ptr<Y>&& r) noexcept;
 ```
 *Effects:* Equivalent to `shared_ptr(std::move(r)).swap(*this)`.
 *Returns:* `*this`.
 ``` cpp
+template<class Y, class D> constexpr shared_ptr& operator=(unique_ptr<Y, D>&& r);
 ```
 *Effects:* Equivalent to `shared_ptr(std::move(r)).swap(*this)`.
 *Returns:* `*this`.
 ##### Modifiers <a id="util.smartptr.shared.mod">[[util.smartptr.shared.mod]]</a>
 ``` cpp
+constexpr void swap(shared_ptr& r) noexcept;
 ```
 *Effects:* Exchanges the contents of `*this` and `r`.
 ``` cpp
+constexpr void reset() noexcept;
 ```
 *Effects:* Equivalent to `shared_ptr().swap(*this)`.
 ``` cpp
+template<class Y> constexpr void reset(Y* p);
 ```
 *Effects:* Equivalent to `shared_ptr(p).swap(*this)`.
 ``` cpp
+template<class Y, class D> constexpr void reset(Y* p, D d);
 ```
 *Effects:* Equivalent to `shared_ptr(p, d).swap(*this)`.
 ``` cpp
+template<class Y, class D, class A> constexpr void reset(Y* p, D d, A a);
 ```
 *Effects:* Equivalent to `shared_ptr(p, d, a).swap(*this)`.
 ##### Observers <a id="util.smartptr.shared.obs">[[util.smartptr.shared.obs]]</a>
 ``` cpp
+constexpr element_type* get() const noexcept;
 ```
 *Returns:* The stored pointer.
 ``` cpp
+constexpr T& operator*() const noexcept;
 ```
 *Preconditions:* `get() != nullptr`.
 *Returns:* `*get()`.
 unspecified what its return type is, except that the declaration
 (although not necessarily the definition) of the function shall be
 well-formed.
 ``` cpp
+constexpr T* operator->() const noexcept;
 ```
 *Preconditions:* `get() != nullptr`.
 *Returns:* `get()`.
 member function is declared. If it is declared, it is unspecified what
 its return type is, except that the declaration (although not
 necessarily the definition) of the function shall be well-formed.
 ``` cpp
+constexpr element_type& operator[](ptrdiff_t i) const;
 ```
+*Preconditions:* `get() != nullptr` is `true`.
+`i` ≥ 0. If `T` is `U[N]`, `i` < `N`.
 *Returns:* `get()[i]`.
 *Throws:* Nothing.
 member function is declared. If it is declared, it is unspecified what
 its return type is, except that the declaration (although not
 necessarily the definition) of the function shall be well-formed.
 ``` cpp
+constexpr long use_count() const noexcept;
 ```
 *Synchronization:* None.
 *Returns:* The number of `shared_ptr` objects, `*this` included, that
 `use_count()`, the result is approximate. In particular,
 `use_count() == 1` does not imply that accesses through a previously
 destroyed `shared_ptr` have in any sense completed. — *end note*]
 ``` cpp
+constexpr explicit operator bool() const noexcept;
 ```
 *Returns:* `get() != nullptr`.
 ``` cpp
+template<class U> constexpr bool owner_before(const shared_ptr<U>& b) const noexcept;
+template<class U> constexpr bool owner_before(const weak_ptr<U>& b) const noexcept;
 ```
 *Returns:* An unspecified value such that
+- `owner_before(b)` defines a strict weak ordering as defined
   in  [[alg.sorting]];
+- `!owner_before(b) && !b.owner_before(*this)` is `true` if and only if
+  `owner_equal(b)` is `true`.
+``` cpp
+size_t owner_hash() const noexcept;
+```
+*Returns:* An unspecified value such that, for any object `x` where
+`owner_equal(x)` is `true`, `owner_hash() == x.owner_hash()` is `true`.
+``` cpp
+template<class U>
+  constexpr bool owner_equal(const shared_ptr<U>& b) const noexcept;
+template<class U>
+  constexpr bool owner_equal(const weak_ptr<U>& b) const noexcept;
+```
+*Returns:* `true` if and only if `*this` and `b` share ownership or are
+both empty. Otherwise returns `false`.
+*Remarks:* `owner_equal` is an equivalence relation.
 ##### Creation <a id="util.smartptr.shared.create">[[util.smartptr.shared.create]]</a>
 The common requirements that apply to all `make_shared`,
 `allocate_shared`, `make_shared_for_overwrite`, and
 `allocate_shared_for_overwrite` overloads, unless specified otherwise,
 are described below.
 ``` cpp
 template<class T, ...>
+ constexpr shared_ptr<T> make_shared(args);
 template<class T, class A, ...>
+ constexpr shared_ptr<T> allocate_shared(const A& a, args);
 template<class T, ...>
+ constexpr shared_ptr<T> make_shared_for_overwrite(args);
 template<class T, class A, ...>
+ constexpr shared_ptr<T> allocate_shared_for_overwrite(const A& a, args);
 ```
 *Preconditions:* `A` meets the *Cpp17Allocator*
 requirements [[allocator.requirements.general]].
   suitable to hold an object of type `U`.
 - When a (sub)object of a non-array type `U` is specified to have an
   initial value of `v`, or `U(l...)`, where `l...` is a list of
   constructor arguments, `allocate_shared` shall initialize this
   (sub)object via the expression
+  - `allocator_traits<A2>::construct(a2, pu, v)` or
+  - `allocator_traits<A2>::construct(a2, pu, l...)`
+  respectively, where `pu` is a pointer of type `remove_cv_t<U>*`
+ pointing to storage suitable to hold an object of type
+  `remove_cv_t<U>` and `a2` of type `A2` is a potentially rebound copy
+ of the allocator `a` passed to `allocate_shared`.
 - When a (sub)object of non-array type `U` is specified to have a
   default initial value, `make_shared` shall initialize this (sub)object
   via the expression `::new(pv) U()`, where `pv` has type `void*` and
   points to storage suitable to hold an object of type `U`.
 - When a (sub)object of non-array type `U` is specified to have a
+  default initial value, `allocate_shared` initializes this (sub)object
+  via the expression `allocator_traits<A2>::construct(a2, pu)`, where
+  `pu` is a pointer of type `remove_cv_t<U>*` pointing to storage
+  suitable to hold an object of type `remove_cv_t<U>` and `a2` of type
+ `A2` is a potentially rebound copy of the allocator `a` passed to
+  `allocate_shared`.
 - When a (sub)object of non-array type `U` is initialized by
   `make_shared_for_overwrite` or `allocate_shared_for_overwrite`, it is
   initialized via the expression `::new(pv) U`, where `pv` has type
   `void*` and points to storage suitable to hold an object of type `U`.
 - Array elements are initialized in ascending order of their addresses.
 - When the lifetime of the object managed by the return value ends, or
   when the initialization of an array element throws an exception, the
   initialized elements are destroyed in the reverse order of their
   original construction.
 - When a (sub)object of non-array type `U` that was initialized by
+  `make_shared`, `make_shared_for_overwrite`, or
+  `allocate_shared_for_overwrite` is to be destroyed, it is destroyed
+  via the expression `pu->~U()` where `pu` points to that object of type
+  `U`.
 - When a (sub)object of non-array type `U` that was initialized by
   `allocate_shared` is to be destroyed, it is destroyed via the
+  expression `allocator_traits<A2>::destroy(a2, pu)` where `pu` is a
+ pointer of type `remove_cv_t<U>*` pointing to that object of type
+ `remove_cv_t<U>` and `a2` of type `A2` is a potentially rebound copy
+ of the allocator `a` passed to `allocate_shared`.
 [*Note 7*: These functions will typically allocate more memory than
 `sizeof(T)` to allow for internal bookkeeping structures such as
 reference counts. — *end note*]
 ``` cpp
 template<class T, class... Args>
+ constexpr shared_ptr<T> make_shared(Args&&... args);                    // T is not array
 template<class T, class A, class... Args>
+ constexpr shared_ptr<T> allocate_shared(const A& a, Args&&... args);    // T is not array
 ```
 *Constraints:* `T` is not an array type.
 *Returns:* A `shared_ptr` to an object of type `T` with an initial value
 ```
 — *end example*]
 ``` cpp
+template<class T>
+ constexpr shared_ptr<T> make_shared(size_t N); // T is U[]
 template<class T, class A>
+ constexpr shared_ptr<T> allocate_shared(const A& a, size_t N);          // T is U[]
 ```
 *Constraints:* `T` is of the form `U[]`.
 *Returns:* A `shared_ptr` to an object of type `U[N]` with a default
 — *end example*]
 ``` cpp
 template<class T>
+ constexpr shared_ptr<T> make_shared();                                  // T is U[N]
 template<class T, class A>
+ constexpr shared_ptr<T> allocate_shared(const A& a);                    // T is U[N]
 ```
 *Constraints:* `T` is of the form `U[N]`.
 *Returns:* A `shared_ptr` to an object of type `T` with a default
 — *end example*]
 ``` cpp
 template<class T>
+ constexpr shared_ptr<T> make_shared(size_t N,
                                       const remove_extent_t<T>& u);     // T is U[]
 template<class T, class A>
+ constexpr shared_ptr<T> allocate_shared(const A& a, size_t N,
                                           const remove_extent_t<T>& u); // T is U[]
 ```
 *Constraints:* `T` is of the form `U[]`.
 — *end example*]
 ``` cpp
 template<class T>
+ constexpr shared_ptr<T> make_shared(const remove_extent_t<T>& u);       // T is U[N]
 template<class T, class A>
+ constexpr shared_ptr<T> allocate_shared(const A& a,
                                           const remove_extent_t<T>& u);   // T is U[N]
 ```
 *Constraints:* `T` is of the form `U[N]`.
 — *end example*]
 ``` cpp
 template<class T>
+ constexpr shared_ptr<T> make_shared_for_overwrite();
 template<class T, class A>
+ constexpr shared_ptr<T> allocate_shared_for_overwrite(const A& a);
 ```
 *Constraints:* `T` is not an array of unknown bound.
 *Returns:* A `shared_ptr` to an object of type `T`.
 — *end example*]
 ``` cpp
 template<class T>
+ constexpr shared_ptr<T> make_shared_for_overwrite(size_t N);
 template<class T, class A>
+ constexpr shared_ptr<T> allocate_shared_for_overwrite(const A& a, size_t N);
 ```
 *Constraints:* `T` is an array of unknown bound.
 *Returns:* A `shared_ptr` to an object of type `U[N]`, where `U` is
 ##### Comparison <a id="util.smartptr.shared.cmp">[[util.smartptr.shared.cmp]]</a>
 ``` cpp
 template<class T, class U>
+ constexpr bool operator==(const shared_ptr<T>& a, const shared_ptr<U>& b) noexcept;
 ```
 *Returns:* `a.get() == b.get()`.
 ``` cpp
 template<class T>
+ constexpr bool operator==(const shared_ptr<T>& a, nullptr_t) noexcept;
 ```
 *Returns:* `!a`.
 ``` cpp
 template<class T, class U>
+ constexpr strong_ordering operator<=>(const shared_ptr<T>& a, const shared_ptr<U>& b) noexcept;
 ```
 *Returns:* `compare_three_way()(a.get(), b.get())`.
 [*Note 8*: Defining a comparison operator function allows `shared_ptr`
 objects to be used as keys in associative containers. — *end note*]
 ``` cpp
 template<class T>
+ constexpr strong_ordering operator<=>(const shared_ptr<T>& a, nullptr_t) noexcept;
 ```
 *Returns:*
 ``` cpp
+compare_three_way()(a.get(), static_cast<typename shared_ptr<T>::element_type*>(nullptr))
 ```
 ##### Specialized algorithms <a id="util.smartptr.shared.spec">[[util.smartptr.shared.spec]]</a>
 ``` cpp
 template<class T>
+ constexpr void swap(shared_ptr<T>& a, shared_ptr<T>& b) noexcept;
 ```
 *Effects:* Equivalent to `a.swap(b)`.
 ##### Casts <a id="util.smartptr.shared.cast">[[util.smartptr.shared.cast]]</a>
 ``` cpp
 template<class T, class U>
+ constexpr shared_ptr<T> static_pointer_cast(const shared_ptr<U>& r) noexcept;
 template<class T, class U>
+ constexpr shared_ptr<T> static_pointer_cast(shared_ptr<U>&& r) noexcept;
 ```
 *Mandates:* The expression `static_cast<T*>((U*)nullptr)` is
 well-formed.
 where *`R`* is `r` for the first overload, and `std::move(r)` for the
 second.
 [*Note 9*: The seemingly equivalent expression
+`shared_ptr<T>(static_cast<T*>(r.get()))` can result in undefined
+behavior, attempting to delete the same object twice. — *end note*]
 ``` cpp
 template<class T, class U>
+ constexpr shared_ptr<T> dynamic_pointer_cast(const shared_ptr<U>& r) noexcept;
 template<class T, class U>
+ constexpr shared_ptr<T> dynamic_pointer_cast(shared_ptr<U>&& r) noexcept;
 ```
 *Mandates:* The expression `dynamic_cast<T*>((U*)nullptr)` is
 well-formed. The expression
 `dynamic_cast<typename shared_ptr<T>::element_type*>(r.get())` is
   returns a non-null value `p`, `shared_ptr<T>(`*`R`*`, p)`, where *`R`*
   is `r` for the first overload, and `std::move(r)` for the second.
 - Otherwise, `shared_ptr<T>()`.
 [*Note 10*: The seemingly equivalent expression
+`shared_ptr<T>(dynamic_cast<T*>(r.get()))` can result in undefined
+behavior, attempting to delete the same object twice. — *end note*]
 ``` cpp
 template<class T, class U>
+ constexpr shared_ptr<T> const_pointer_cast(const shared_ptr<U>& r) noexcept;
 template<class T, class U>
+ constexpr shared_ptr<T> const_pointer_cast(shared_ptr<U>&& r) noexcept;
 ```
 *Mandates:* The expression `const_cast<T*>((U*)nullptr)` is well-formed.
 *Returns:*
 where *`R`* is `r` for the first overload, and `std::move(r)` for the
 second.
 [*Note 11*: The seemingly equivalent expression
+`shared_ptr<T>(const_cast<T*>(r.get()))` can result in undefined
+behavior, attempting to delete the same object twice. — *end note*]
 ``` cpp
 template<class T, class U>
   shared_ptr<T> reinterpret_pointer_cast(const shared_ptr<U>& r) noexcept;
 template<class T, class U>
 where *`R`* is `r` for the first overload, and `std::move(r)` for the
 second.
 [*Note 12*: The seemingly equivalent expression
+`shared_ptr<T>(reinterpret_cast<T*>(r.get()))` can result in undefined
+behavior, attempting to delete the same object twice. — *end note*]
 ##### `get_deleter` <a id="util.smartptr.getdeleter">[[util.smartptr.getdeleter]]</a>
 ``` cpp
 template<class D, class T>
+ constexpr D* get_deleter(const shared_ptr<T>& p) noexcept;
 ```
 *Returns:* If `p` owns a deleter `d` of type cv-unqualified `D`, returns
 `addressof(d)`; otherwise returns `nullptr`. The returned pointer
 remains valid as long as there exists a `shared_ptr` instance that owns

Diff to HTML by rtfpessoa