STD::RANGES::SUBRANGE(3)

okay so bestie, welcome to the Library Functions Manual page for std::range...t, _Kind >(3) 💖 this is all about the std::ranges::subrange class template, and it's literally so iconic.

---

✨ NAME ✨

std::ranges::subrange< _It, _Sent, _Kind > — the ranges::subrange class template. it's giving range subview realness, no cap.

---

🌸 SYNOPSIS 🌸

       #include <ranges>

Inherits std::ranges::view_interface< _Derived >. (so it's in the view_interface clique, periodt)

💖 Public Member Functions 💖

here's the whole squad of member functions, every single one, bestie:

       constexpr subrange (__detail::__convertible_to_non_slicing< _It > auto
           __i, _Sent __s) noexcept(is_nothrow_constructible_v< _It,
           decltype(__i)> &&is_nothrow_constructible_v< _Sent, _Sent & >)
       constexpr subrange (__detail::__convertible_to_non_slicing< _It > auto
           __i, _Sent __s, __size_type __n)
           noexcept(is_nothrow_constructible_v< _It, decltype(__i)>
           &&is_nothrow_constructible_v< _Sent, _Sent & >)
       template<__detail::__different_from< subrange > _Rng>
           requires _S_store_sizeconstexpr subrange (_Rng &&__r)
           noexcept(noexcept(subrange(__r, ranges::size(__r)))) &&sized_range<
           _Rng >"
       template<__detail::__different_from< subrange > _Rng>
           requires (!_S_store_size)constexpr subrange (_Rng &&__r)
           noexcept(noexcept(subrange(ranges::begin(__r), ranges::end(__r))))"
       template<borrowed_range _Rng>
           requires (_Kind == subrange_kind::sized)constexpr subrange (_Rng
           &&__r, __size_type __n)
           noexcept(noexcept(subrange(ranges::begin(__r), ranges::end(__r),
           __n)))"
       constexpr subrange & advance (iter_difference_t< _It > __n)
       constexpr decltype(auto) back ()
       constexpr decltype(auto) back () const
       constexpr _It begin ()
       constexpr _It begin () const
       constexpr auto cbegin ()
       constexpr auto cbegin () const
       constexpr auto cend ()
       constexpr auto cend () const
       constexpr auto data () const
           noexcept(noexcept(ranges::begin(_M_derived())))
       constexpr auto data () noexcept(noexcept(ranges::begin(_M_derived())))
       constexpr bool empty () const
       constexpr bool empty () noexcept(noexcept(_S_empty(_M_derived())))
       constexpr _Sent end () const
       constexpr decltype(auto) front ()
       constexpr decltype(auto) front () const
       constexpr subrange next (iter_difference_t< _It > __n=1) &&
       constexpr subrange next (iter_difference_t< _It > __n=1) const &
       template<__detail::__different_from< subrange > _PairLike> constexpr
           operator _PairLike () const
       constexpr operator bool () const
           noexcept(noexcept(ranges::empty(_M_derived())))
       constexpr operator bool ()
           noexcept(noexcept(ranges::empty(_M_derived())))
       template<random_access_range _Range = _Derived> constexpr decltype(auto)
           operator[] (range_difference_t< _Range > __n)
       template<random_access_range _Range = const _Derived> constexpr
           decltype(auto) operator[] (range_difference_t< _Range > __n) const
       constexpr subrange prev (iter_difference_t< _It > __n=1) const
       constexpr __size_type size () const
       constexpr auto size () noexcept(noexcept(_S_size(_M_derived())))

🫶 Friends 🫶

       struct views::_Drop

---

🌸 Detailed Description 🌸

okay so the actual class template definition is this masterpiece:

   template<input_or_output_iterator _It, sentinel_for< _It > _Sent = _It,
       subrange_kind _Kind = sized_sentinel_for<_Sent, _It> ?
       subrange_kind::sized : subrange_kind::unsized>
       requires (_Kind == subrange_kind::sized || !sized_sentinel_for<_Sent,
       _It>)
       class std::ranges::subrange< _It, _Sent, _Kind >"The ranges::subrange
       class template.

---

💖 Author 💖

Generated automatically by Doxygen for libstdc++ from the source code. (so it's the Doxygen machine's work, not a human, but it ate and left no crumbs)

---

mwah 💋 this was libstdc++, page std::range...t, _Kind >(3). no date bestie, it's timeless ✨