::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_map<int, double> map{{4, 4.13}, {9, 9.24}, {1, 1.09}}; for (auto it = map.cbegin(); it != map.cend(); ++it) std::cout << '[' << it->first << "] = " << it->second << '\n'; // Unlike std::map's bidirectional iterators, the std::flat_map iterators // are random-access, so they can be used with the operator[]: auto it = map.cbegin(); assert(it[0] == map[1]); assert(it[1] == map[4]); assert(it[2] == map[9]); }

Output:

[1] = 1.09 [4] = 4.13 [9] = 9.24

[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] |