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: 


複雜度

常量。

迭代器有效性

沒有變化。

另見