std::
map::begin
公众成员函数 <map>| C++98 | iterator begin(); const_iterator begin() const; |
返回迭代器的起始位置
返回指向map容器中第一个元素的迭代器。
因为map容器始终保持其元素的顺序，begin指向首先遵循容器排序标准的元素。
如果容器为空，则不能对返回的迭代器值进行解引用.
☲ 参数
- none
☉ 返回值
指向容器中第一个元素的迭代器。
如果map对象是const限定的，则该函数返回const_iterator对象。否则，它将返回一个iterator。
成员类型iterator和const_iterator是指向元素的双向迭代器类型。
☣ 示例
// map::begin/end
#include <iostream>
#include <map>
int main ()
{
int myints[] = {75,23,65,42,13};
std::map<int> mymap (myints,myints+5);
std::cout << "mymap contains:";
for (std::map<int>::iterator it=mymap.begin(); it!=mymap.end(); ++it)
std::cout << ' ' << *it;
std::cout << '\n';
return 0;
} |
输出:
mymap contains: 13 23 42 65 75
mymap contains: 13 23 42 65 75
✥ 复杂度
常量
☣ 迭代器的有效性
不变
⇄ 数据竞争
容器被访问(const和非const版本都不会修改容器)。
并发地访问集合的元素是安全的。
☂ 异常安全性
No-throw保证:这个成员函数从不抛出异常。
返回迭代器的复制构造或赋值也保证不会引发抛出。
🍄 另请参阅
| map::rbegin | 返回指向容器中最后一个元素的反向迭代器(公众成员函数) |
| map::rend | 返回指向map开始元素之前的理论元素的反向迭代器(公众成员函数) |
| map::end | 返回一个指向容器末尾元素的下一个元素的迭代器(公众成员函数) |