std::experi...ol_resource(3)

okay so this is the std::experi...ol_resource(3) manual page from the C++ Standard Libary — yes, that spelling is straight from the header, and we’re folding the manual name right in here so you don’t have to read a stuffy title line. 💅

🌸 NAME 🌸

Bestie, the page name is a whole mouthful: <std::experimental::pmr::unsynchronized_pool_resource::unsynchronized_pool_resource>.

And because the original NAME section literally says it twice with a - between them, here it is again, no cap: <std::experimental::pmr::unsynchronized_pool_resource::unsynchronized_pool_resource>. 🫶

✨ Synopsis ✨

Here’s the constructor lineup, overloads (1) through (5), all tagged library fundamentals TS. The signatures are copied exactly — no renaming, no “fixing,” no vibe-based edits:

unsynchronized_pool_resource();                            (1)
(library fundamentals TS)

explicit unsynchronized_pool_resource( memory_resource* upstream );    (2)
(library fundamentals TS)

explicit unsynchronized_pool_resource( const pool_options& opts );     (3)
(library fundamentals TS)

unsynchronized_pool_resource( const pool_options& opts, memory_resource* upstream );    (4)
(library fundamentals TS)

unsynchronized_pool_resource( const unsynchronized_pool_resource& ) = delete;    (5)
(library fundamentals TS)

So yeah: it constructs an unsynchronized_pool_resource. Iconic behavior. 💖

Overloads 1-4) construct an unsynchronized_pool_resource using the specified upstream memory resource and tuned according to the specified options. The resulting object holds a copy of upstream but does not own the resource to which upstream points — important, bestie, do not gloss over that.

The overloads not taking opts as a parameter use a default constructed instance of pool_options as the options. The overloads not taking upstream as a parameter use the return value of std::experimental::pmr::get_default_resource() as the upstream memory resource.

Overload 5)? Copy constructor is deleted. Periodt. Copying this thing is not on the menu. 🚫

🎀 Parameters 🎀

Two parameters, two little besties:

• opts — a pool_options struct containing the constructor options.
• upstream — the upstream memory resource to use.

💀 Exceptions 💀

Overloads 1-4) throw only if a call to the allocate() function of the upstream resource throws. It is unspecified if or under what conditions such a call takes place — so don’t act like you know, because the page literally says it’s unspecified. 😭

🦋 Category 🦋

This page is in the category:

• Noindexed pages

💖 cute sign-off: source/version/date from the footer are http://cppreference.com, 2024.06.10, and the page is std::experi...ol_resource(3) — mwah, bye bestie! 🎀