map::rend-c和c++中文资料站

C&C++标准库

std::

map::rend

公众成员函数 <map>

C++98

      reverse_iterator rend();
const_reverse_iterator rend() const;

返回一个指向容器中第一个元素之前的理论元素的反向迭代器

返回一个反向迭代器，指向map容器中第一个元素之前的理论元素(被认为是它的反向端)。

map::rbegin和map::rend之间的范围包含了容器的所有元素(以相反的顺序)。

☲ 参数

none

☉ 返回值

返回一个指向序列容器中第一个元素之前的理论元素的反向迭代器.

如果map对象是const限定的，则该函数返回一个const_reverse_iterator对象。否则，它将返回一个reverse_iterator。

成员类型reverse_iterator和const_reverse_iterator是指向元素的反向双向迭代器类型。参见map成员类型。

☣ 示例

// map::rbegin/rend
#include <iostream>
#include <map>

int main ()
{
  std::map<char,int> mymap;

  mymap['x'] = 100;
  mymap['y'] = 200;
  mymap['z'] = 300;

  // show content:
  std::map<char,int>::reverse_iterator rit;
  for (rit=mymap.rbegin(); rit!=mymap.rend(); ++rit)
    std::cout << rit->first << " => " << rit->second << '\n';

  return 0;
}

输出:
z => 300
y => 200
x => 100

✥ 复杂度

常量

☣ 迭代器的有效性

不变

⇄ 数据竞争

容器被访问(const和非const版本都不会修改容器)。
调用不访问包含的元素，但返回的迭代器可用于访问或修改元素。
同时访问或修改不同的元素是安全的。

☂ 异常安全性

No-throw保证:这个成员函数从不抛出异常。
返回迭代器的复制构造或赋值也保证不会引发抛出。

🍄 另请参阅

map::begin	返回指向map容器第一个元素的迭代器(公众成员函数)
map::end	返回一个指向列表容器末尾元素的下一个元素的迭代器(公众成员函数)
list::rbegin	返回指向容器中最后一个元素的反向迭代器(公众成员函数)