public member type
<unordered_set>

std::unordered_set::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_set容器(1)或其存储桶(2)中“尾后”元素的迭代器。

end不指向任何元素,但指向unordered_set容器中最后一个元素的下一个位置(其“尾后”位置)。因此,返回值不应被解引用——它通常用于描述范围的开端,例如[begin,end).

请注意,unordered_set对象不保证其元素的排序方式。但无论如何,从它的begin到它的endend

unordered_set 中的所有迭代器都对元素具有 const 访问权限(即使那些类型未以覆盖了容器(或存储桶)中的所有元素,直到迭代器失效。const_

参数

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

返回值

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

所有返回类型(iterator, const_iterator, local_iteratorconst_local_iterator)都是成员类型。在unordered_set类模板中,它们是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_set::begin/end example
#include <iostream>
#include <string>
#include <unordered_set>

int main ()
{
  std::unordered_set<std::string> myset =
  {"Mercury","Venus","Earth","Mars","Jupiter","Saturn","Uranus","Neptune"};

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

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

  return 0;
}

可能的输出
myset contains: Venus Jupiter Neptune Mercury Earth Uranus Saturn Mars
myset's buckets contain:
bucket #0 contains:
bucket #1 contains: Venus
bucket #2 contains: Jupiter
bucket #3 contains: 
bucket #4 contains: Neptune Mercury
bucket #5 contains: 
bucket #6 contains: Earth
bucket #7 contains: Uranus Saturn
bucket #8 contains: Mars
bucket #9 contains: 
bucket #10 contains: 


复杂度

常量。

迭代器有效性

没有变化。

另见