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

iterator end() noexcept;	(1)	(since C++23) (constexpr since C++26)
const_iterator end() const noexcept;	(2)	(since C++23) (constexpr since C++26)
const_iterator cend() const noexcept;	(3)	(since C++23) (constexpr since C++26)

Returns an iterator past the last element of *this.

This returned iterator only acts as a sentinel. It is not guaranteed to be dereferenceable.

[edit] Return value

Iterator past the last element.

[edit] Complexity

Constant.

[edit] Example

#include #include int main() { std::flat_multimap<int, int> map{{4, 13}, {9, 94}, {1, 19}, {4, 42}}; for (auto it = map.cbegin(); it != map.cend(); ++it) std::cout << '[' << it->first << "] = " << it->second << '\n'; // Unlike std::multimap's bidirectional iterators, the std::flat_multimap // iterators are random-access, so they can be used with the operator[]: auto it = map.cbegin(); assert(it[1] == 19); assert(it[4] == 13); assert(it[4] == 42); assert(it[9] == 94); }

Output:

[1] = 19 [4] = 13 [4] = 42 [9] = 94

[edit] See also

| | returns an iterator to the beginning (public member function) [edit] | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | returns an iterator to the end of a container or array (function template) [edit] |