std::experi...al::weak_ptr(3)

💖 NAME 💖

std::experimental::weak_ptr — std::experimental::weak_ptr (yes bestie, that's the whole name section, the manpage said it twice and honestly? iconic of it) ✨

---

✨ SYNOPSIS ✨

okay so first things first, she lives here:

Defined in header <experimental/memory>

template< class T > class weak_ptr;      (library fundamentals TS)

And what is she? Okay so std::experimental::weak_ptr is a modified version of std::weak_ptr — like, the glow-up edition 💅 — and she does two things the original doesn't:

• she interoperates with std::experimental::shared_ptr 🫶
• she has support for arrays 🌈

That's it, that's the whole pitch, no cap. 🎀

---

🦋 MEMBER TYPES 🦋

One (1) member type, and she ate:

• element_type — defined as std::remove_extent_t<T> ⭐

---

🌸 MEMBER FUNCTIONS 🌸

• constructor — constructs new weak_ptr (public member function) 🧚

---

👑 MEMBERS AND NON-MEMBERS IDENTICAL TO std::weak_ptr 👑

Everything under this heading is the same energy as std::weak_ptr — except the parts below have a little twist:

Heads up bestie: the following member functions work with std::experimental::shared_ptr instead of std::shared_ptr, and with std::experimental::weak_ptr instead of std::weak_ptr. The behavior is otherwise identical. So don't overthink it 💀

🎀 Member functions 🎀

• destructor — destroys a weak_ptr (public member function of std::weak_ptr<T>)
• operator= — assigns the weak_ptr (public member function of std::weak_ptr<T>)

🔥 Modifiers 🔥

• reset — releases the ownership of the managed object (public member function of std::weak_ptr<T>)
• swap — swaps the managed objects (public member function of std::weak_ptr<T>)

⭐ Observers ⭐

• use_count — returns the number of shared_ptr objects that manage the object (public member function of std::weak_ptr<T>)
• expired — checks whether the referenced object was already deleted (public member function of std::weak_ptr<T>)
• lock — creates a shared_ptr that manages the referenced object (public member function of std::weak_ptr<T>)
• owner_before — provides owner-based ordering of weak pointers (public member function of std::weak_ptr<T>)

💜 Non-member functions 💜

Plot twist: this non-member function is declared in the std::experimental namespace, and works with std::experimental::weak_ptr rather than std::weak_ptr — but otherwise she behaves identically to the corresponding C++14 function. Same girl, different namespace 😌

• std::swap(std::weak_ptr) — specializes the std::swap algorithm (C++11) (function template)

---

🙈 EXAMPLE 🙈

This section is incomplete.

Reason: no example 😭 (ngl we're all waiting on this one)

---

🍓 CATEGORIES 🍓

• Noindexed pages
• Todo no example

---

Okay that's the whole page, bestie — you understood it, I'm so proud of you, mwah 🫶💖

Catch her at http://cppreference.com, dated 2024.06.10, filed under std::experi...al::weak_ptr(3) in the C++ Standard Library. Slay, go read some docs, periodt. ✨👑