Home C&C++函数库 c++ 语法 程序源码 Linux C库

std::

unordered_multimap::cbegin

公众成员函数  <unordered_map>
container iterator (1)
const_iterator cbegin() const noexcept;
bucket iterator (2)
const_local_iterator cbegin ( size_type n ) const;

返回一个指向unordered_multimap容器或其中一个桶开头的常量迭代器

返回一个const_iterator对象,指向unordered_multimap容器(1)或其中一个桶(2)中的第一个元素。

const_iterator是指向const容的迭代器。这个迭代器可以递增或递减(除非它本身也是const), 就像unordered_multimap::begin返回的迭代器一样,但它不能用来修改它所指向的内容。

☲  参数


n
桶数。这个值应该小于bucket_count
它是一个可选参数,用于改变成员函数的行为:如果设置了, 则迭代器检索到的是桶的第一个元素,否则则指向容器的第一个元素。
size_type是一种无符号整型。

☉  返回值



指向容器(1)或桶(2)中的第一个元素的const_iterator对象。

const_iteratorconst_local_iterator都是成员类型。在unordered_multimap类模板中,这些是前向迭代器类型。

Const_local_iterator是与const_iterator属于同一类别的迭代器。 它们的value_type、difference_type、指针和引用成员类型也是相同的。但是迭代器本身并不一定是相同的类型

☣  示例



// unordered_multimap::cbegin/cend example
#include <iostream>
#include <unordered_map>

int main ()
{
  std::unordered_multimap<std::string,std::string> myumm = {
    {"apple","red"},
    {"apple","green"},
    {"orange","orange"},
    {"strawberry","red"}
  };

  std::cout << "myumm contains:";
  for ( auto it = myumm.cbegin(); it != myumm.cend(); ++it )
    std::cout << " " << it->first << ":" << it->second;  // cannot modify *it
  std::cout << std::endl;

  std::cout << "myumm's buckets contain:\n";
  for ( unsigned i = 0; i < myumm.bucket_count(); ++i) {
    std::cout << "bucket #" << i << " contains:";
    for ( auto local_it = myumm.cbegin(i); local_it!= myumm.cend(i); ++local_it )
      std::cout << " " << local_it->first << ":" << local_it->second;
    std::cout << std::endl;
  }

  return 0;
}

输出:
myumm contains: apple:red apple:green orange:orange strawberry:red
myumm's buckets contain:
bucket #0 contains:
bucket #1 contains:
bucket #2 contains: apple:red apple:green
bucket #3 contains: orange:orange
bucket #4 contains: strawberry:red

✥ 复杂度



常量

☣ 迭代器的有效性



不变

🍄  另请参阅



unordered_multimap::find 获取元素的迭代器(公众成员函数)
unordered_multimap::end 返回一个指向unordered_multimap容器或其中一个桶末尾元素的下一个元素的迭代器(公众成员函数)
unordered_multimap::cbegin 返回一个指向unordered_multimap容器或其中一个桶开头的常量迭代器(公众成员函数)

联系我们 免责声明 关于CandCplus 网站地图