std::ranges::cend - cppreference.com (original) (raw)

| Defined in header | | | | ---------------------------------------------------------------------------------------------------------- | | ------------------------------------------ | | Defined in header | | | | inline namespace /* unspecified */ { inline constexpr /* unspecified */ cend = /* unspecified */; } | | (since C++20) (customization point object) | | Call signature | | | | template< class T > requires /* see below */ constexpr /* see below */ auto cend( T&& t ); | | (since C++20) |

Returns a sentinel for the constant iterator(since C++23) indicating the end of a const-qualified(until C++23) range.

If ranges::cend(e) is valid for an expression e, where decltype((e)) is T, then CT models std::ranges::range, and(until C++23) std::sentinel_for<S, I> is true in all cases, where S is decltype(ranges::cend(e)), and I is decltype(ranges::cbegin(e)). Additionally, S models constant-iterator if it models input_iterator.(since C++23)

Customization point objects

The name ranges::cend denotes a customization point object, which is a const function object of a literal semiregular class type. See CustomizationPointObject for details.

[edit] Example

#include #include #include #include   int main() { std::vector vec{3, 1, 4}; int arr[]{5, 10, 15};   assert(std::ranges::find(vec, 5) == std::ranges::cend(vec)); assert(std::ranges::find(arr, 5) != std::ranges::cend(arr)); }

[edit] See also

| | returns a sentinel indicating the end of a range(customization point object)[edit] | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | returns an iterator to the end of a container or array (function template) [edit] |