STD::RANGES::SINGLE_VIEW(3)

💖 NAME 💖

std::ranges::single_view< _Tp > — a view that contains exactly one element. that's it. that's the whole vibe. one (1) element. iconic behaviour honestly.

---

✨ SYNOPSIS ✨

first things first bestie, you gotta pull it in:

#include <ranges>

and heads up — it inherits from:

std::ranges::view_interface< single_view< _Tp > >

so all that view_interface energy comes along for free, no cap. 🦋

---

🫶 Public Member Functions 🫶

okay so here's the full roster of what this baby can do, and every single one is constexpr because of course it is, she's built different:

• constexpr single_view (_Tp &&__t) — constructs from an rvalue _Tp. it's marked noexcept(is_nothrow_move_constructible_v< _Tp >) so it stays chill as long as moving _Tp is chill. ✨
• constexpr single_view (const _Tp &__t) — the copy-ish constructor from a const _Tp &. noexcept(is_nothrow_copy_constructible_v< _Tp >). copy energy, still valid. 💅
• template<typename... _Args> constexpr single_view (in_place_t, _Args &&... __args) — the fancy one, she takes an in_place_t tag plus a pack of _Args &&... __args and builds the element right there in place. noexcept(is_nothrow_constructible_v< _Tp, _Args... >). it's giving "I construct on my own terms". 🎀
• constexpr decltype(auto) back () — hands you the back element. there's only one, so like… same element, bestie. 🙈
• constexpr const _Tp * begin () const noexcept — const iterator to the start. noexcept, obviously. ⭐
• constexpr _Tp * begin () noexcept — non-const version of begin(). same deal, no const in sight. 🔥
• constexpr auto cbegin () — const begin, the c-flavoured one.
• constexpr auto cend () — const end, matching the above.
• constexpr const _Tp * data () const noexcept — const pointer to the underlying data. noexcept. 🧚
• constexpr _Tp * data () noexcept — non-const pointer to the underlying data. noexcept. 🌸
• constexpr const _Tp * end () const noexcept — const iterator past the one element. noexcept. 🍓
• constexpr _Tp * end () noexcept — non-const version of end(). noexcept. 💜
• constexpr decltype(auto) front () — hands you the front element. again… it's the same single element. she's both the front AND the back. main character energy. 👑
• constexpr operator bool () — the truthiness conversion, and she's noexcept(noexcept(ranges::empty(_M_derived()))). whether she's truthy depends entirely on whether the derived view is empty. the way that it just delegates… obsessed. 😭
• constexpr decltype(auto) operator[] (range_difference_t< _Range > __n) — index into it with an __n of type range_difference_t< _Range >. ✨

---

⭐ Static Public Member Functions ⭐

these two are static, constexpr, and noexcept — the holy trinity of "I don't need an instance to tell you this":

• static constexpr bool empty () noexcept — is it empty? static. constexpr. noexcept. the whole package. 💖
• static constexpr size_t size () noexcept — how big is it? returns a size_t. also static, constexpr, and noexcept. 🌈

---

🌸 Detailed Description 🌸

okay the actual declaration, verbatim, because you deserve to see her in her full form:

template<copy_constructible _Tp>
    requires is_object_v<_Tp>
class std::ranges::single_view< _Tp >

and the description, straight up:

"A view that contains exactly one element."

one element. that's the whole class. she said "I hold a single thing and I hold it FLAWLESSLY." no more, no less. periodt. 💅

note the requirements bestie — _Tp has to be copy_constructible, and there's a requires clause demanding is_object_v<_Tp>. so no function types, no references, no weirdness. only objects allowed. 🦋

---

👑 Author 👑

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

so like, no human author, just Doxygen doing her little automated thing. the robots ate, fr fr. 🤖💖

---

okay bestie that's the whole page!! this came out of the libstdc++ manual — the page title is std::range...view< _Tp >(3) (yes the title is abbreviated like that, that's just how she's listed) and there's no date on the footer, just the libstdc++ source stamp. go forth and hold exactly one element. slay. 🎀✨💅