key_iterator 类

class QMap::key_iterator

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

Qt 5.6 中引入该类。

• 所有成员列表，包括继承的成员

公共成员函数

详细描述

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

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

for (QMap<int, QString>::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<int> 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_iterator 和 QMap::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!=()。