std::unordered_multiset<Key,Hash,KeyEqual,Allocator>::end, std::unordered_multiset<Key,Hash,KeyEqual,Allocator>::cend
iterator end() noexcept; | (1) | (since C++11) |
const_iterator end() const noexcept; | (2) | (since C++11) |
const_iterator cend() const noexcept; | (3) | (since C++11) |
Возвращает итератор на элемент, следующий за последним элементом unordered_multiset.
Этот элемент используется как плейсхолдер; попытка получить к нему доступ приводит к неопределенному поведению.
Параметры
(нет)
Возвращаемое значение
Итератор на элемент, следующий за последним элементом.
Сложность
Постоянная.
Примечания
Поскольку как iterator , так и const_iterator являются константными итераторами (и могут, по сути, быть одного типа), изменить элементы контейнера с помощью итератора, возвращённого любой из этих функций-членов, невозможно.
Пример
#include <iostream>
#include <iterator>
#include <string>
#include <unordered_set>
int main()
{
const std::unordered_multiset<std::string> words =
{
"some", "words", "to", "count",
"count", "these", "words"
};
for (auto it = words.begin(); it != words.end(); )
{
auto count = words.count(*it);
std::cout << *it << ":\t" << count << '\n';
std::advance(it, count); // all count elements have equivalent keys
}
}Возможный вывод:
some: 1 words: 2 to: 1 count: 2 these: 1
См. также
| возвращает итератор на начало (публичный член-функция) |
|
|
(C++11)(C++14) | возвращает итератор на конец контейнера или массива (шаблонная функция) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/unordered_multiset/end