std::experi...ource::reset(3)

🌸 NAME 🌸

std::experimental::unique_resource::reset — std::experimental::unique_resource::reset. yes, it's literally the same name twice, and honestly? iconic. 💅

This is the page from the C++ Standard Libary manual — that spelling is the header's, not mine, bestie 😭 — and it's all about the reset member of std::experimental::unique_resource. 🦋

---

✨ Synopsis ✨

here's the exact synopsis, untouched because code is sacred:

void reset() noexcept; (1) (library fundamentals TS v3)

template< class RR >   (2) (library fundamentals TS v3)
void reset( RR&& r );

1. Overload (1) — Disposes the resource by calling the deleter with the underlying resource handle if the unique_resource owns it. The unique_resource does not own the resource after the call. periodt. 💅
2. Overload (2) — Replaces the resource by calling (1) and then assigns the stored resource handle with std::forward<RR>(r) if std::is_nothrow_assignable_v<RS, RR> is true, otherwise std::as_const(r), where RS is the type of stored resource handle. The unique_resource owns the resource after the call. 🫶

If copy-assignment of the stored resource handle throws an exception, it calls del_(r), where del is the deleter object.

This overload participates in overload resolution only if the selected assignment expression assigning the stored resource handle is well-formed.

The program is ill-formed if del_(r) is ill-formed.

The behavior is undefined if del_(r) results in undefined behavior or throws an exception. so yeah, that's a big ol' "do not pass go" situation 😭💀

---

🎀 Parameters 🎀

• r — resource handle for a new resource to manage. 🫶

---

💖 Return value 💖

• (none) — literally no return value, bestie. 💅

---

🫶 Exceptions 🫶

• 2) Any exception thrown in assigning the stored resource handle. 😭

---

🧚 Notes 🧚

The mechanism ensures no leaking of resources. slay, no leaks. ✨

---

🍓 Example 🍓

This section is incomplete.

Reason: no example.

(not me leaving the example section empty — iconic but incomplete 💀)

---

👑 See also 👑

• reset replaces the managed object — (public member function of std::unique_ptr<T,Deleter>). 👑

---

💅 Category 💅

• Todo no example 🎀

---

that's the whole page, bestie! 💖 source/version: http://cppreference.com, date 2024.06.10 — go off, C++ docs 👑✨