table of contents
std::flat_multimap::end,(3) | C++ Standard Libary | std::flat_multimap::end,(3) |
NAME¶
std::flat_multimap::end, - std::flat_multimap::end,
Synopsis¶
iterator end() noexcept; (1) (since C++23)
const_iterator end() const noexcept; (2) (since C++23)
const_iterator cend() const noexcept; (3) (since C++23)
Returns an iterator to the element following the last element of the
flat_multimap.
This element acts as a placeholder; attempting to access it results in
undefined
behavior.
range-begin-end.svg
Parameters¶
(none)
Return value¶
Iterator to the element following the last element.
Complexity¶
Constant.
Example¶
// Run this code
#include <iostream>
#include <flat_map>
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
See also¶
begin returns an iterator to the beginning
cbegin (public member function)
end
cend returns an iterator to the end of a container or array
(C++11) (function template)
(C++14)
2024.06.10 | http://cppreference.com |