std::ranges::subrange<I,S,K>::begin

From cppreference.com
< cpp‎ | ranges‎ | subrange
 
 
Ranges library
Range access
Range conversions
(C++23)
Range primitives



Dangling iterator handling
Range concepts
Views

Factories






Adaptors
Range adaptor objects
Range adaptor closure objects
Helper items
 
std::ranges::subrange
Member functions
Observers
subrange::begin
(C++20)
Iterator operations
Deduction guides
Non-member functions
(C++20)
Helper types
(C++20)
 
constexpr I begin() const requires std::copyable<I>;
(1) (since C++20)
[[nodiscard]] constexpr I begin() requires (!std::copyable<I>);
(2) (since C++20)

Obtains the iterator to the first element of the subrange, or the end iterator if the view is empty.

range-begin-end.svg

1) Returns a copy of the stored iterator if the iterator type is copyable.
2) Returns an iterator move-constructed from the stored iterator if the iterator type is not copyable.

Parameters

(none)

Return value

1) An iterator copy-constructed from the stored iterator.
2) An iterator move-constructed from the stored iterator.

Notes

A call to (2) may leave the stored iterator in a valid but unspecified state, depending on the behavior of the move constructor of I.

Example

See also

(C++20)
obtains the sentinel
(public member function)
(C++11)(C++14)
returns an iterator to the beginning of a container or array
(function template)
returns an iterator to the beginning of a range
(customization point object)