公共成员函数
<map>

std::multimap::begin

      iterator begin();const_iterator begin() const;
      iterator begin() noexcept;const_iterator begin() const noexcept;
返回指向容器开头的迭代器
返回一个指向 `multimap` 容器中第一个元素的迭代器。

由于 `multimap` 容器始终保持其元素有序,begin该迭代器指向根据容器的 排序准则 应该排在最前面的元素。

如果容器为空,则返回的迭代器值不应被解引用。

参数



返回值

指向容器中第一个元素的迭代器。

如果multimap对象是const限定的,则该函数返回一个const_iterator。否则,它返回一个iterator.

成员类型iteratorconst_iterator是指向元素的(类型为value_type).
请注意,value_type在 `multimap` 容器中是pair<const key_type, mapped_type> 的别名.

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// multimap::begin/end
#include <iostream>
#include <map>

int main ()
{
  std::multimap<char,int> mymultimap;

  mymultimap.insert (std::pair<char,int>('a',10));
  mymultimap.insert (std::pair<char,int>('b',20));
  mymultimap.insert (std::pair<char,int>('b',150));

  // show content:
  for (std::multimap<char,int>::iterator it=mymultimap.begin(); it!=mymultimap.end(); ++it)
    std::cout << (*it).first << " => " << (*it).second << '\n';

  return 0;
}

输出
a => 10
b => 20
b => 150


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

访问容器(const 和非 const 版本都不会修改容器)。
调用该函数不访问任何包含的元素,但返回的迭代器可用于访问或修改元素。并发访问或修改不同元素是安全的。

异常安全

无异常保证:此成员函数从不抛出异常。
还可以保证返回的迭代器的复制构造或赋值永远不会引发异常。

另见