Files
cppdraft_translate/cppdraft/range/all.md
2025-10-25 03:02:53 +03:00

7.1 KiB
Raw Blame History

[range.all]

25 Ranges library [ranges]

25.7 Range adaptors [range.adaptors]

25.7.6 All view [range.all]

25.7.6.1 General [range.all.general]

1

#

views::all returns a view that includes all elements of its range argument.

2

#

The name views::all denotes a range adaptor object ([range.adaptor.object]).

Given a subexpression E, the expressionviews::all(E) is expression-equivalent to:

  • (2.1)

    decay-copy(E) if the decayed type of E models view.

  • (2.2)

    Otherwise, ref_view{E} if that expression is well-formed.

  • (2.3)

    Otherwise, owning_view{E}.

25.7.6.2 Class template ref_view [range.ref.view]

1

#

ref_view is a view of the elements of some other range.

🔗

namespace std::ranges {template<range R>requires is_object_vclass ref_view : public view_interface<ref_view> {private: R* r_; // exposition onlypublic:template<different-from<ref_view> T>requires see belowconstexpr ref_view(T&& t); constexpr R& base() const { return **r_; }constexpr iterator_t begin() const { return ranges::begin(**r_); }constexpr sentinel_t end() const { return ranges::end(**r_); }constexpr bool empty() constrequires requires { ranges::empty(**r_); }{ return ranges::empty(**r_); }constexpr auto size() const requires sized_range{ return ranges::size(**r_); }constexpr auto reserve_hint() const requires approximately_sized_range{ return ranges::reserve_hint(**r_); }constexpr auto data() const requires contiguous_range{ return ranges::data(**r_); }}; template ref_view(R&) -> ref_view;}

🔗

template<[different-from](range.utility.helpers#concept:different-from "25.5.2Helper concepts[range.utility.helpers]")<ref_view> T> requires see below constexpr ref_view(T&& t);

2

#

Effects: Initializes r_ withaddressof(static_cast<R&>(std::forward(t))).

3

#

Remarks: Let FUN denote the exposition-only functionsvoid FUN(R&);void FUN(R&&) = delete;

The expression in the requires-clause is equivalent to:convertible_to<T, R&> && requires { FUN(declval()); }

25.7.6.3 Class template owning_view [range.owning.view]

1

#

owning_view is a move-only view of the elements of some other range.

🔗

namespace std::ranges {template<range R>requires movable && (!is-initializer-list) // see [range.refinements]class owning_view : public view_interface<owning_view> {private: R r_ = R(); // exposition onlypublic: owning_view() requires default_initializable = default; constexpr owning_view(R&& t);

owning_view(owning_view&&) = default; owning_view& operator=(owning_view&&) = default; constexpr R& base() & noexcept { return r_; }constexpr const R& base() const & noexcept { return r_; }constexpr R&& base() && noexcept { return std::move(r_); }constexpr const R&& base() const && noexcept { return std::move(r_); }constexpr iterator_t begin() { return ranges::begin(r_); }constexpr sentinel_t end() { return ranges::end(r_); }constexpr auto begin() const requires range{ return ranges::begin(r_); }constexpr auto end() const requires range{ return ranges::end(r_); }constexpr bool empty() requires requires { ranges::empty(r_); }{ return ranges::empty(r_); }constexpr bool empty() const requires requires { ranges::empty(r_); }{ return ranges::empty(r_); }constexpr auto size() requires sized_range{ return ranges::size(r_); }constexpr auto size() const requires sized_range{ return ranges::size(r_); }constexpr auto reserve_hint() requires approximately_sized_range{ return ranges::reserve_hint(r_); }constexpr auto reserve_hint() const requires approximately_sized_range{ return ranges::reserve_hint(r_); }constexpr auto data() requires contiguous_range{ return ranges::data(r_); }constexpr auto data() const requires contiguous_range{ return ranges::data(r_); }};}

🔗

constexpr owning_view(R&& t);

2

#

Effects: Initializes r_ with std::move(t).