std::

set::end

公众成员函数  <set> C++98 C++11
返回一个指向容器末尾元素的下一个元素(past-the-end)的迭代器

past-the-end元素是在set中紧跟最后一个元素的理论元素。它不指向任何元素，因此不能对它解引用。

由于标准库函数使用的范围不包括其结束迭代器所指向的元素，因此该函数通常与set::begin组合使用， 以指定包含容器中所有元素的范围。

如果容器为空，则该函数返回与set::begin相同的结果。

☲  参数

---

none

☉  返回值

---

返回一个指向容器末尾元素的下一个元素的迭代器

如果set对象是const限定的，则该函数返回const_iterator对象。否则，它将返回一个iterator。

成员类型iterator和const_iterator是指向元素的双向迭代器类型。

☣  示例

---

// set::begin/end #include <iostream> #include <set> int main () { int myints[] = {75,23,65,42,13}; std::set<int> myset (myints,myints+5); std::cout << "myset contains:"; for (std::set<int>::iterator it=myset.begin(); it!=myset.end(); ++it) std::cout << ' ' << *it; std::cout << '\n'; return 0; }

✥ 复杂度

---

常量

☣ 迭代器的有效性

---

不变

⇄ 数据竞争

---

容器被访问(const和非const版本都不会修改容器)。
并发地访问集合的元素是安全的。

☂ 异常安全性

---

No-throw保证:这个成员函数从不抛出异常。
返回迭代器的复制构造或赋值也保证不会引发抛出。

🍄  另请参阅

---

set::begin	返回指向set容器第一个元素的迭代器(公众成员函数)
set::rbegin	返回指向容器中最后一个元素的反向迭代器(公众成员函数)
set::rend	返回一个指向列表容器中第一个元素之前的理论元素的反向迭代器(公众成员函数)