NAME¶

std::flat_multimap::begin, - std::flat_multimap::begin,

Synopsis¶

iterator begin() noexcept; (1) (since C++23)
const_iterator begin() const noexcept; (2) (since C++23)
const_iterator cbegin() const noexcept; (3) (since C++23)

Returns an iterator to the first element of the flat_multimap.

If the flat_multimap is empty, the returned iterator will be equal to end().

range-begin-end.svg

Parameters¶

(none)

Return value¶

Iterator to the first 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¶

end returns an iterator to the end
cend (public member function)
begin
cbegin returns an iterator to the beginning of a container or array
(C++11) (function template)
(C++14)