__GNU_CXX::TEMPORARY_BUFFER(3)

💖 __gnu_cxx::temporary_buffer< _ForwardIterator, _Tp > 💖

okay bestie, welcome to the libstdc++ manual — Library Functions Manual energy, but make it cute. this one's about a lil buffer that's ✨temporary✨ (the name said it, not me).

---

🌸 NAME 🌸

__gnu_cxx::temporary_buffer< _ForwardIterator, _Tp > — literally the whole vibe is in the name, no notes 💅

---

✨ SYNOPSIS ✨

#include <memory>

Inherits std::_Temporary_buffer< _ForwardIterator, _Tp >. yes she's a nepo baby, and we love that for her 🫶

---

🎀 Public Types 🎀

• typedef pointer iterator — the iterator type, slaying as always
• typedef value_type * pointer — a pointer, but make it value_type
• typedef ptrdiff_t size_type — the size type, iconic
• typedef _Tp value_type — the value type. it's _Tp. that's the whole personality

---

🦋 Public Member Functions 🦋

• temporary_buffer (_ForwardIterator __first, _ForwardIterator __last) — Requests storage large enough to hold a copy of [first,last).
• ~temporary_buffer () — Destroys objects and frees storage. she's done, she's logging off 😭
• size_type _M_requested_size () const — Returns the size requested by the constructor; may be >size().
• iterator begin () — As per Table mumble.
• iterator end () — As per Table mumble.
• size_type size () const — As per Table mumble.

"As per Table mumble" is not me being silly, bestie, that's the actual text. the docs said mumble and I said periodt. 💀

---

🌈 Protected Attributes 🌈

• struct std::_Temporary_buffer::_Impl _M_impl — the internal impl, protected, don't touch her
• size_type _M_original_len — the original length, preserved for the girls and the gays

---

💜 Detailed Description 💜

template<class _ForwardIterator, class _Tp = typename
    std::iterator_traits<_ForwardIterator>::value_type>
    struct __gnu_cxx::temporary_buffer< _ForwardIterator, _Tp >

"This class provides similar behavior and semantics of the standard functions get_temporary_buffer() and return_temporary_buffer(), but encapsulated in a type vaguely resembling a standard container.

By default, a temporary_buffer<Iter> stores space for objects of whatever type the Iter iterator points to. It is constructed from a typical [first,last) range, and provides the begin(), end(), size() functions, as well as requested_size(). For non-trivial types, copies of *first will be used to initialize the storage.

malloc is used to obtain underlying storage.

Like get_temporary_buffer(), not all the requested memory may be available. Ideally, the created buffer will be large enough to hold a copy of [first,last), but if size() is less than requested_size(), then this didn't happen."

⚠️ lowkey important: you do not always get the memory you asked for. if size() is less than requested_size(), the universe simply said no. check before you use it, bestie, fr fr.

---

🔥 Constructor & Destructor Documentation 🔥

template<class _ForwardIterator, class _Tp = typename
    std::iterator_traits<_ForwardIterator>::value_type>
    __gnu_cxx::temporary_buffer< _ForwardIterator, _Tp >::temporary_buffer
    (_ForwardIterator __first, _ForwardIterator __last) [inline]

Requests storage large enough to hold a copy of [first,last).

References std::_Temporary_buffer< _ForwardIterator, _Tp >::_Temporary_buffer(), and __gnu_cxx::distance().

---

template<class _ForwardIterator, class _Tp = typename
    std::iterator_traits<_ForwardIterator>::value_type>
    __gnu_cxx::temporary_buffer< _ForwardIterator, _Tp >::~temporary_buffer
    () [inline]

Destroys objects and frees storage. cleanup queen 🧚

---

👑 Member Function Documentation 👑

template<typename _ForwardIterator, typename _Tp> size_type
    std::_Temporary_buffer< _ForwardIterator, _Tp >::_M_requested_size ()
    const [inline],  [inherited]

Returns the size requested by the constructor; may be >size(). so like, what you wanted vs what you got — very "my expectations vs reality" energy 😭

---

template<typename _ForwardIterator, typename _Tp> iterator
    std::_Temporary_buffer< _ForwardIterator, _Tp >::begin () [inline],
    [inherited]

As per Table mumble.

Referenced by _Temporary_buffer().

---

template<typename _ForwardIterator, typename _Tp> iterator
    std::_Temporary_buffer< _ForwardIterator, _Tp >::end () [inline],
    [inherited]

As per Table mumble.

Referenced by _Temporary_buffer().

---

template<typename _ForwardIterator, typename _Tp> size_type
    std::_Temporary_buffer< _ForwardIterator, _Tp >::size () const [inline],
    [inherited]

As per Table mumble.

---

⭐ Author ⭐

Generated automatically by Doxygen for libstdc++ from the source code.

---

and that's the whole page, bestie 💖 this one came straight out of the libstdc++ manual, generated automatically by Doxygen from the source code — no cap, no date stamp on this one, just vibes and libstdc++ forever. mwah 🫶✨