Qt中文文档-QMap-key-iterator

key_iterator 类

class QMap::key_iterator

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

Qt 5.6 中引入该类。

公共成员函数

const_iterator base() const
bool operator!=(key_iterator other) const
const Key & operator*() const
key_iterator & operator++()
key_iterator operator++(int)
key_iterator & operator–()
key_iterator operator–(int)
const Key * operator->() const
bool operator==(key_iterator other) const

详细描述

除了 operator*() 和 operator->() 返回键而不是值以外,QMap::key_iterator 基本和 QMap::const_iterator 相同。

多数情况下应该使用 QMap::iteratorQMap::const_iterator,通过调用 QMap::iterator::key() 可以很容易地取得键:

for (QMap::const_iterator it = map.cbegin(), end = map.cend(); it != end; ++it) {
    cout << "The key: " << it.key() << Qt::endl
    cout << "The value: " << it.value() << Qt::endl;
    cout << "Also the value: " << (*it) << Qt::endl;
}

然而,如果想对 QMap 的键应用 STL 算法,就需要一个能解引用出键而不是值的迭代器。通过 QMap::key_iterator 就能直接对一组键应用 STL 算法而不必调用 QMap::keys(),这个函数比较低效,因为它首先要遍历一遍 QMap,然后分配内存创建一个临时的 QList

// Inefficient, keys() is expensive
QList keys = map.keys();
int numPrimes = std::count_if(map.cbegin(), map.cend(), isPrimeNumber);
qDeleteAll(map2.keys());

// Efficient, no memory allocation needed
int numPrimes = std::count_if(map.keyBegin(), map.keyEnd(), isPrimeNumber);
qDeleteAll(map2.keyBegin(), map2.keyEnd());

QMap::key_iterator 是 const 的,键是不可能被修改的。

QMap::key_iterator 的默认构造函数创建一个未初始化的迭代器。必须使用 QMap::keyBegin() 或 QMap::keyEnd() 等 QMap 函数来初始化它。

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

另请参阅 QMap::const_iteratorQMap::iterator

成员函数文档

const_iterator key_iterator::base() const

返回该 key_iterator 基于的底层 const_iterator

bool key_iterator::operator!=(key_iterator other) const

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

另请参阅 operator==()。

const Key &key_iterator::operator*() const

返回当前元素的键。

key_iterator &key_iterator::operator++()

前置 ++ 运算符(++i)将迭代器向前移动到 map(译者注:原文是 hash,应为笔误。)中的下一个元素并返回指向新位置元素的迭代器。

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

另请参阅 operator–()。

key_iterator key_iterator::operator++(int)

这是一个重载函数。

后置 ++ 运算符(i++)将迭代器向前移动到 map(译者注:原文是 hash,应为笔误。)中的下一个元素并返回指向旧位置元素的迭代器。

key_iterator &key_iterator::operator–()

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

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

另请参阅 operator++()。

key_iterator key_iterator::operator–(int)

这是一个重载函数。

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

const Key *key_iterator::operator->() const

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

bool key_iterator::operator==(key_iterator other) const

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

另请参阅 operator!=()。


文章作者: 张小飞
版权声明: 本博客所有文章除特別声明外,均采用 CC BY-NC-ND 4.0 许可协议。转载请注明来源 张小飞 !
  目录