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)