Qt中文文档-QMap-const-iterator

const_iterator 类

class QMap::const_iterator

QMap::const_iterator 类为 QMapQMultiMap 提供 STL 风格的常量迭代器。更多内容…

公共成员类型

typedef iterator_category

公共成员函数

const_iterator(const iterator &other)
const_iterator()
const Key & key() const
const T & value() const
bool operator!=(const const_iterator &other) const
const T & operator*() const
const_iterator operator+(int j) const
const_iterator & operator++()
const_iterator operator++(int)
const_iterator & operator+=(int j)
const_iterator operator-(int j) const
const_iterator & operator–()
const_iterator operator–(int)
const_iterator & operator-=(int j)
const T * operator->() const
bool operator==(const const_iterator &other) const

详细描述

QMap 同时提供 STL 风格迭代器Java 风格迭代器。STL 风格迭代器更底层,使用更笨拙;同时也稍快一些。对于已经了解 STL 的开发者来说更加熟悉。

QMap<Key, T>::const_iterator 用来遍历 QMap(或QMultiMap)。如果想在遍历时修改 QMap,必须使用QMap::iterator。对于非常量 QMap,使用 QMap::const_iterator 通常是好的编程实践,除非需要在遍历时改变 QMap。const 迭代器稍快一些并可以提高代码可读性。

QMap::const_iterator 的默认构造函数创建一个未初始化的迭代器。必须在开始遍历前使用 QMap::constBegin(),QMap::constEnd() 或 QMap::find() 等 QMap 函数初始化它。下面是一个典型的循环,该循环打印出 map 中的所有键值对:

QMap map;
map.insert("January", 1);
map.insert("February", 2);
...
map.insert("December", 12);

QMap::const_iterator i;
for (i = map.constBegin(); i != map.constEnd(); ++i)
    cout << i.key() << ": " << i.value() << Qt::endl;

与无序存储元素的 QHash 不同,QMap 通过键的大小有序存储元素。相同键的元素(因为 map 是一个 QMultiMap)将按照从最新到最早插入的顺序连续出现。

同一 map 可以使用多个迭代器。如果向 map 添加元素,已有的迭代器仍然有效。如果从 map 移除元素,指向被移除元素的迭代器会变成悬空迭代器。

警告:隐式共享容器迭代器的工作方式和 STL 迭代器不完全相同。当容器的迭代器还处于活动状态时,应该避免拷贝容器。更多信息请参阅隐式共享迭代器问题

另请参阅 QMap::iteratorQMap::key_iteratorQMapIterator.

成员类型文档

typedef const_iterator::iterator_category

std::bidirectional_iterator_tag 的别名,表明该迭代器是双向迭代器。

成员函数文档

const_iterator::const_iterator(const iterator &other)

构造一个 other 的副本。

const_iterator::const_iterator()

构造一个未初始化的迭代器。

一定不要对未初始化的迭代器调用 key(),value() 和 operator++() 等函数。使用前要用 operator=() 赋值。

另请参阅 QMap::constBegin() 和 QMap::constEnd()。

const Key &const_iterator::key() const

返回当前元素的键。

另请参阅 value()。

const T &const_iterator::value() const

返回当前元素的值。

另请参阅 key() 和 operator*()。

bool const_iterator::operator!=(const const_iterator &other) const

如果 other 与本迭代器指向的元素不同,返回 true;否则返回 false

另请参阅 operator==()。

const T &const_iterator::operator*() const

返回当前元素的值。

value()。

另请参阅 key()。

const_iterator const_iterator::operator+(int j) const

返回迭代器,指向该迭代器之前 j 个位置的元素。(如果 j 为负,则为之后 j 个位置。)

j 值较大时,该操作会比较慢。

另请参阅 operator-()。

const_iterator &const_iterator::operator++()

前置 ++ 运算符(++i)将迭代器向前移动到 map 中的下一个元素并返回指向新位置元素的迭代器。

QMap::end() 调用该函数将导致未定义结果。

另请参阅 operator–()。

const_iterator const_iterator::operator++(int)

这是一个重载函数。

后置 ++ 运算符(i++)将迭代器向前移动到 map 中的下一个元素并返回指向旧位置元素的迭代器。

const_iterator &const_iterator::operator+=(int j)

使迭代器前进 j 个元素。(如果 j 为负,则后退 j 个位置。)

j 值较大时,该操作会比较慢。

另请参阅 operator-=() 和 operator+()。

const_iterator const_iterator::operator-(int j) const

返回迭代器,指向该迭代器之后 j 个位置的元素。(如果 j 为负,则为之前 j 个位置。)

j 值较大时,该操作会比较慢。

另请参阅 operator+()。

const_iterator &const_iterator::operator–()

前置 – 运算符(--i)使前一个元素成为当前元素并返回指向新位置元素的迭代器。

QMap::begin() 调用该函数将导致未定义结果。

另请参阅 operator++()。

const_iterator const_iterator::operator–(int)

这是一个重载函数。

后置 – 运算符(i--)使前一个元素成为当前元素并返回指向旧位置元素的迭代器。

const_iterator &const_iterator::operator-=(int j)

使迭代器后退 j 个元素。(如果 j 为负,则前进 j 个位置。)

j 值较大时,该操作会比较慢。

另请参阅 operator+=() 和 operator-()。

const T *const_iterator::operator->() const

返回指向当前元素值的指针。

另请参阅 value()。

bool const_iterator::operator==(const const_iterator &other) const

如果 other 与本迭代器指向相同的元素,返回 true;否则返回 false

另请参阅 operator!=()。


文章作者: 张小飞
版权声明: 本博客所有文章除特別声明外,均采用 CC BY-NC-ND 4.0 许可协议。转载请注明来源 张小飞 !
 上一篇
Qt中文文档-Resource_Compiler_rcc Qt中文文档-Resource_Compiler_rcc
资源编译器(rcc)rcc 工具用于在编译期将资源数据集成至 Qt 应用。它基于 Qt 资源文件(.qrc) 来生成包含资源数据的 C++ 源文件。 使用方式: rcc [选项列表] <输入列表> RCC 接受如下命令行选项:
下一篇 
Qt中文文档-Synchronizing_Threads Qt中文文档-Synchronizing_Threads
同步线程尽管线程的初衷是让代码并行运行,仍然有许多时候,线程必须停下来等待其他线程。例如,若有两个线程尝试同时写入同一个变量,则结果是不确定的。让线程强制等待另外线程,这样的机制被称为互斥,是一种保护共享资源(如数据)的常用技术。 Qt 在
  目录