std::ranges...in_view::end(3)

std::ranges...in_view::end(3) ✨

okay so bestie, this page comes from the C++ Standard Libary manual (yup, that spelling is their vibe 😭), and we’re talking about the end member of std::ranges::join_view. The header/footer shorten the page name to std::ranges...in_view::end(3), but the actual NAME is right below, no cap.

💖 NAME 💖

std::ranges::join_view::end — std::ranges::join_view::end

✨ Synopsis ✨

Two overloads, both since C++20:

constexpr auto end();

(1) (since C++20)

constexpr auto end() const
    requires ranges::input_range<const V> &&
             std::is_reference_v<ranges::range_reference_t<const V>>;

(2) (since C++20)

Returns a sentinel or an iterator representing the end of the join_view.

Let base_ be the underlying view:

1. Equivalent to

if constexpr (ranges::forward_range<V> &&
              std::is_reference_v<ranges::range_reference_t<V>> &&
              ranges::forward_range<ranges::range_reference_t<V>> &&
              ranges::common_range<V> &&
              ranges::common_range<ranges::range_reference_t<V>>)
    return /*iterator*/<__SimpleView<V>>{*this, ranges::end(base_)};
else
    return /*sentinel*/<__SimpleView<V>>{*this};

2. Equivalent to

if constexpr (ranges::forward_range<const V> &&
              std::is_reference_v<ranges::range_reference_t<const V>>
&&
              ranges::forward_range<ranges::range_reference_t<const V>>
&&
              ranges::common_range<const V> &&
              ranges::common_range<ranges::range_reference_t<const V>>)
    return /*iterator*/<true>{*this, ranges::end(base_)};
else
    return /*sentinel*/<true>{*this};

🎀 Parameters 🎀

(none) — literally none.

🌸 Return value 🌸

1. sentinel which compares equal to the end iterator.
2. iterator to the element following the last element.

🦋 Example 🦋

This section is incomplete Reason: no example

no example bestie 😭 the page really said “figure it out” 💀

🔥 See also 🔥

• begin — returns an iterator to the beginning (public member function, C++20)
• ranges::end — returns a sentinel indicating the end of a range (customization point object, C++20)

👑 Category 👑

• Todo no example

---

mwah 💋 source/version: http://cppreference.com, date: 2024.06.10 🫶💖