C++

参考

<iterator>

函数模板
<iterator> <array> <deque> <forward_list> <list> <map> <regex> <set> <string> <unordered_map> <unordered_set> <vector>

std::end

容器 (1)
template <class Container>  auto end (Container& cont) -> decltype (cont.end());template <class Container>  auto end (const Container& cont) -> decltype (cont.end());
数组 (2)
template <class T, size_t N>  T* end (T(&arr)[N]);
容器 (1)
template <class Container>  auto end (Container& cont) -> decltype (cont.end());template <class Container>  auto end (const Container& cont) -> decltype (cont.end());
数组 (2)
template <class T, size_t N>  constexpr T* end (T(&arr)[N]) noexcept;
指向末尾的迭代器
返回一个指向序列中“越过末尾”元素的迭代器

(1) 容器
函数返回 cont.end()。
(2) 数组
函数返回 arr+N。

如果序列是“空的”，则返回的值与使用相同参数调用 begin 所返回的值相等。

这些函数模板定义在多个头文件中：每个头文件都包含所有容器和数组类型的通用模板，而不仅仅是特定的重载。这些头文件是： <iterator>、<array>、<deque>、<forward_list>、<list>、map、<regex>、<set>、<string>、<unordered_map>、<unordered_set> 和 <vector>。

反之，end 在头文件 <initializer_list> 和 <valarray> 中被重载（具有不同的定义）。

参数

cont
定义了成员 end 的类类型对象。
arr
一个数组。

返回值

对于 (1)，与 cont.end() 返回的相同。
对于 (2)，指向数组最后一个元素之后位置的指针。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
 
// std::begin / std::end example
#include <iostream>     // std::cout
#include <vector>       // std::vector, std::begin, std::end

int main () {
  int foo[] = {10,20,30,40,50};
  std::vector<int> bar;

  // iterate foo: inserting into bar
  for (auto it = std::begin(foo); it!=std::end(foo); ++it)
    bar.push_back(*it);

  // iterate bar: print contents:
  std::cout << "bar contains:";
  for (auto it = std::begin(bar); it!=std::end(bar); ++it)
    std::cout << ' ' << *it;
  std::cout << '\n';

  return 0;
}

输出
bar contains: 10 20 30 40 50


数据竞争

参数被访问但未被修改。
调用不会访问序列中的任何元素，但返回的迭代器可用于访问或修改它们。

异常安全

提供与对参数执行的操作相同的保证级别（对于标准容器和数组，这是无异常保证）。

另见

begin
指向起始位置的迭代器 (函数模板)