C++

参考

<unordered_set>

unordered_multiset

public member type
<unordered_set>

std::unordered_multiset::end

container iterator (1)
      iterator end() noexcept;const_iterator end() const noexcept;
bucket iterator (2)
      local_iterator end (size_type n);const_local_iterator end (size_type n) const;
返回指向末尾的迭代器
返回一个指向 `unordered_multiset` 容器 (1) 或其某个桶 (2) 中“超越最后一个元素”位置的迭代器。

由end不指向任何元素，而是指向 `unordered_multiset` 容器中最后一个元素的下一个位置（其“超越最后一个元素”的位置）。因此，返回的值不应被解引用——它通常用于描述一个范围的开端，例如：[begin,end).

请注意，`unordered_multiset` 对象不对具有不同值的元素如何排序做出任何保证。但是，在任何情况下，从其begin到其end的范围都将覆盖容器（或桶）中的所有元素，直到迭代器失效。

在 `unordered_multiset` 中的所有迭代器都对元素具有 const 访问权限（即使是那些类型前没有前缀 `const_）：可以在容器中插入或删除元素，但在容器中不能修改它们。

参数

n
桶编号。该值应小于 bucket_count。
这是一个可选参数，它改变了此成员函数的行为：如果设置了该参数，则检索到的迭代器指向存储桶的“越尾”元素，否则它指向容器的“越尾”元素。
成员类型size_type是一种无符号整型类型。

返回值

指向容器（1）或存储桶（2）末尾之后元素的迭代器。

所有返回类型（iterator, const_iterator, local_iterator和const_local_iterator）都是成员类型。在 `unordered_multiset` 类模板中，这些是 forward iterator 类型。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
 
// unordered_multiset::begin/end example
#include <iostream>
#include <string>
#include <unordered_set>

int main ()
{
  std::unordered_multiset<std::string> myums =
    {"father","mother","son","daughter","son","son"};

  std::cout << "myums contains:";
  for ( auto it = myums.begin(); it != myums.end(); ++it )
    std::cout << " " << *it;
  std::cout << std::endl;

  std::cout << "myums's buckets contain:\n";
  for ( unsigned i = 0; i < myums.bucket_count(); ++i) {
    std::cout << "bucket #" << i << " contains:";
    for ( auto local_it = myums.begin(i); local_it!= myums.end(i); ++local_it )
      std::cout << " " << *local_it;
    std::cout << std::endl;
  }

  return 0;
}

可能的输出
myums contains: father mother daughter son son son
myset's buckets contain:
bucket #0 contains:
bucket #1 contains: father
bucket #2 contains: mother
bucket #3 contains: daughter son son son
bucket #4 contains: 
bucket #5 contains: 
bucket #6 contains:


复杂度

常量。

迭代器有效性

没有变化。

另见

unordered_multiset::begin
返回指向起始位置的迭代器 (公开成员类型)
unordered_multiset::cend
返回指向末尾的 const_iterator (public member type)
unordered_multiset::find
获取指向元素的迭代器 (公共成员函数)