std::
unordered_map::cbegin
公众成员函数 <unordered_map>
container iterator (1) |
const_iterator cbegin() const noexcept;
|
bucket iterator (2) |
const_local_iterator cbegin ( size_type n ) const;
|
返回一个指向unordered_map容器或其中一个桶开头的常量迭代器
返回一个
const_iterator对象,指向
unordered_map容器(1)或其中一个桶(2)中的第一个元素。
const_iterator是指向
const容的迭代器。这个迭代器可以递增或递减(除非它本身也是
const),
就像
unordered_map::begin返回的迭代器一样,但它不能用来修改它所指向的内容。
☲ 参数
-
n
-
桶数。这个值应该小于bucket_count。
它是一个可选参数,用于改变成员函数的行为:如果设置了,
则迭代器检索到的是桶的第一个元素,否则则指向容器的第一个元素。
size_type是一种无符号整型。
☉ 返回值
指向容器(1)或桶(2)中的第一个元素的
const_iterator对象。
const_iterator和
const_local_iterator都是成员类型。在
unordered_map类模板中,这些是前向迭代器类型。
Const_local_iterator是与
const_iterator属于同一类别的迭代器。
它们的
value_type、difference_type、指针和引用成员类型也是相同的。但是迭代器本身并不一定是相同的类型
☣ 示例
// unordered_map::cbegin/cend example
#include <iostream>
#include <unordered_map>
int main ()
{
std::unordered_map<std::string,std::string> mymap;
mymap = {{"Australia","Canberra"},{"U.S.","Washington"},{"France","Paris"}};
std::cout << "mymap contains:";
for ( auto it = mymap.cbegin(); it != mymap.cend(); ++it )
std::cout << " " << it->first << ":" << it->second; // cannot modify *it
std::cout << std::endl;
std::cout << "mymap's buckets contain:\n";
for ( unsigned i = 0; i < mymap.bucket_count(); ++i) {
std::cout << "bucket #" << i << " contains:";
for ( auto local_it = mymap.cbegin(i); local_it!= mymap.cend(i); ++local_it )
std::cout << " " << local_it->first << ":" << local_it->second;
std::cout << std::endl;
}
return 0;
}
|
输出:
mymap contains: France:Paris Australia:Canberra U.S.:Washington
mymap's buckets contain:
bucket #0 contains:
bucket #1 contains:
bucket #2 contains:
bucket #3 contains:
bucket #4 contains:
bucket #5 contains: France:Paris
bucket #6 contains:
bucket #7 contains: Australia:Canberra
bucket #8 contains: U.S.:Washington
bucket #9 contains:
bucket #10 contains:
✥ 复杂度
常量
☣ 迭代器的有效性
不变
🍄 另请参阅
unordered_map::find |
获取元素的迭代器(公众成员函数) |
unordered_map::end |
返回一个指向unordered_map容器或其中一个桶末尾元素的下一个元素的迭代器(公众成员函数) |
unordered_map::cbegin |
返回一个指向unordered_map容器或其中一个桶开头的常量迭代器(公众成员函数) |