0
0

QT QList＜T＞介绍与应用、详解、使用说明、官方手册翻译

文章目录

1. 简介

QList<T>是目前最常用的容器类 。它存储了给定类型的值的一个列表，而这些值可以通过索引访问。在内部，QList使用数组来实现，一确保进行快速的基于索引的访问。可以使用QList::append()和QList::prepend()在列表的两端添加项目，也可以使用QList::insert()在列表的中间插入项目。常用的QStringList继承自QList<QString>。

2. 使用示例

#include<QCoreApplication>#include<QList>#include<QDebug>intmain(int argc,char*argv[]){
    QCoreApplication a(argc, argv);// 定义QList变量
    QList<QString> list;// 插入项目
    list <<"aa"<<"bb"<<"cc";// 查询和重新定义元素if(list[1]=="bb"){
        list[1]="ab";}// 替换第3个元素
    list.replace(2,"bc");// 将“cc”换为“bc”// 打印元素qDebug()<<"the list is: ";for(int i=0; i<list.size();++i){qDebug()<< list.at(i);// 现在列表为aa ab bc}// 在列表尾部添加元素
    list.append("dd");// 在列表头部添加元素
    list.prepend("mm");// 从列表中删除第3个项目，并获取它        
    QString str = list.takeAt(2);// 打印刚才删除的元素qDebug()<<"at(2) item is: "<< str;// 打印列表qDebug()<<"the list is: ";for(int i=0; i<list.size();++i){qDebug()<< list.at(i);// 现在列表为mm aa bc dd}// 在位置2插入项目
    list.insert(2,"mm");// 交换项目1和项目3
    list.swap(1,3);// 打印列表qDebug()<<"the list is: ";for(int i=0; i<list.size();++i){qDebug()<< list.at(i);// 现在列表为mm bc mm aa dd}// 列表中是否包含“mm”qDebug()<<"contains 'mm' ?"<< list.contains("mm");// 包含“mm”的个数qDebug()<<"the 'mm' count: "<< list.count("mm");// 第一个“mm”的位置，默认从位置0开始往前查找，返回第一个匹配的项目的位置qDebug()<<"the first 'mm' index: "<< list.indexOf("mm");// 第二个“mm”的位置，我们指定从位置1开始往前查找qDebug()<<"the second 'mm' index: "<< list.indexOf("mm",2);return a.exec();}

执行结果：
在这里插入图片描述
程序说明：

  • 添加元素
    QList<QString> list;
    list <<"aa"<<"bb"<<"cc";// 插入项目
  • 赋值操作
    list[0]="aa";
  • 替换操作
    list.replace(2,"bc");
  • 获取大小
int length = list.size();
  • 获取元素值
    list.at(i)
  • 在列表尾部添加
    list.append("dd");
  • 在列表头部添加
    list.prepend("mm");
  • 删除元素并获取
    QString str = list.takeAt(2);
  • 在指定位置插入
    list.insert(2,"mm");
  • 交换元素
    list.swap(1,3);
  • 列表是否包含某值
    list.contains("mm");
  • 列表包含某值个数
    list.count("mm");
  • 元素位置，从0开始查找
    list.indexOf("mm");
  • 元素位置，从指定位置查找
    list.indexOf("mm",2);

3. 官方手册

https://doc.qt.io/qt-5/qlist.html

4. Member Function Documentation

QList::QList(InputIterator first, InputIterator last)

构造一个包含迭代器范围[first, last]中的内容的QList。
InputIterator的值类型必须转换为T。
这个函数是在Qt 5.14中引入的。

QList::QList(std::initializer_list<T> args)

从args指定的std::initializer_list构造一个列表。
这个构造函数只有在编译器支持c++ 11初始化器列表时才启用。
这个函数是在Qt 4.8中引入的。

QList::QList(QList<T>&&other)

Move构造一个QList实例，使其指向其他对象指向的同一对象。
此功能在Qt 5.2中引入。

QList::QList(const QList<T>&other)

构造其他的副本。
由于QList是隐式共享的，因此此操作花费的时间是恒定的。 这使得从函数快速返回QList成为可能。 如果共享实例被修改，它将被复制（写时复制），这需要花费线性时间。
另请参阅operator =（）。

QList :: QList（）

构造一个空列表。

QList <T>＆QList ::operator=（QList <T>&& other）

将其他移动到此QList实例。
此功能在Qt 5.2中引入。

QList <T>＆QList ::operator=（const QList <T>＆other）

将其他分配给该列表，并返回对该列表的引用。

QList::~QList()

销毁该列表。 对列表中的值的引用以及该列表的所有迭代器均无效。

void QList::append(const T &value)

在列表的末尾插入值。
示例：
在这里插入图片描述
这与

list.insert(size(), value)

相同.
如果未共享此列表，则此操作通常非常快（摊销的固定时间），因为QList在其内部缓冲区的两侧预分配了额外的空间，以允许在列表的两端快速增长。

另参见

operator<<()

, 

prepend()

, 和 

insert()

.

void QList::append(const QList<T>&value)

这是一个重载功能。
将值列表的项目追加到此列表。
此功能在Qt 4.5中引入。

另参见

operator<<()

和 

operator+=()

.

const T &QList::at(int i)const

返回列表中索引位置i处的项目。 我必须是列表中的有效索引位置（即 0<=i<size()）。
此功能非常快（恒定时间）。

另参见

value()

和 

operator[]()

.

T &QList::back()

提供此功能是为了实现STL兼容性。 它等效于last（）。 该列表不能为空。 如果列表可以为空，请在调用此函数之前调用isEmpty（）。

const T &QList::back()const

这是一个重载功能。

QList::iterator QList::begin()

返回一个STL样式的迭代器，该迭代器指向列表中的第一项。

另参见

constBegin()

和 

end()

.

QList::const_iterator QList::begin()const

这是一个重载功能

QList::const_iterator QList::cbegin()const

返回指向列表中第一项的const STL样式迭代器。
此功能在Qt 5.0中引入。

另参见

begin()

和 

cend()

.

QList::const_iterator QList::cend()const

返回一个const STL样式的迭代器，该迭代器指向列表中最后一个项目之后的虚拟项目。
此功能在Qt 5.0中引入。

另参见

cbegin()

和 

end()

.

void QList::clear()

从列表中删除所有项目。

另参见

removeAll()

.

QList::const_iterator QList::constBegin()const

返回指向列表中第一项的const STL样式迭代器。

另参见 

begin()

和

constEnd()

.

QList::const_iterator QList::constEnd()const

返回一个const STL样式迭代器，该迭代器指向列表中最后一个项之后的假想项。

另参见

constBegin()

和

end()

.

const T &QList::constFirst()const

返回对列表中第一项的常量引用。列表不能为空。如果列表可以为空，请在调用此函数之前调用isEmpty（）。
qt5.6中引入了这个函数。

另参见

constLast()

, 

isEmpty()

, 和 

first()

.

const T &QList::constLast()const

返回对列表中最后一项的引用。列表不能为空。如果列表可以为空，请在调用此函数之前调用isEmpty（）。
qt5.6中引入了这个函数。

另参见

constFirst()

, 

isEmpty()

, 和

last()

.

bool QList::contains(const T &value)const

如果列表包含值的出现，则返回true；否则返回false。
此函数要求值类型具有运算符==（）的实现。

另参见

indexOf()

和

count()

.

int QList::count(const T &value)const

返回值在列表中出现的次数。
此函数要求值类型具有运算符==（）的实现。

另参见

contains()

和

indexOf()

.

int QList::count()const

返回列表中的项数。这实际上与size（）相同。

QList::const_reverse_iterator QList::crbegin()const

以相反的顺序返回指向列表中第一项的const STL样式反向迭代器。
qt5.6中引入了这个函数。

另参见

begin()

, 

rbegin()

, 和

rend()

.

QList::const_reverse_iterator QList::crend()const

以相反的顺序返回一个const STL样式的反向迭代器，该迭代器指向列表中最后一项之后的一个。
此功能在Qt 5.6中引入。

另参见

end()

, 

rend()

, 和 

rbegin()

.

bool QList::empty()const

提供此功能是为了实现STL兼容性。 它等效于isEmpty（），如果列表为空，则返回true。

QList::iterator QList::end()

返回一个STL样式的迭代器，该迭代器指向列表中最后一个项目之后的虚拟项目。

另请参见

begin（）

和

constEnd（）

。

QList::const_iterator QList::end()const

这是一个重载函数。

bool QList::endsWith(const T &value)const

如果此列表不为空并且其最后一项等于value，则返回true；否则，返回true。 否则返回false。
此功能在Qt 4.5中引入。

另请参见

isEmpty（）

和

contains（）

。

QList::iterator QList::erase(QList::iterator pos)

从列表中删除与迭代器pos关联的项目，并将迭代器返回到列表中的下一个项目（可能是end（））。

另请参见

insert（）

和

removeAt（）

。

QList::iterator QList::erase(QList::iterator begin, QList::iterator end)

这是一个重载函数。
从开始到（但不包括）结束删除所有项目。 将迭代器返回到调用之前结束引用的同一项目。

T &QList::first()

返回对列表中第一项的引用。 该列表不能为空。 如果列表可以为空，请在调用此函数之前调用isEmpty（）。
另请参见

constFirst（）

，

last（）

和

isEmpty（）

。

const T &QList::first()const

这是一个重载函数。

[static] QList<T> QList::fromSet(const QSet<T>&set)

返回带有包含在set中的数据的QList对象。 QList中元素的顺序未定义。

示例：

  QSet<int> set;
  set <<20<<30<<40<<...<<70;

  QList<int> list = QList<int>::fromSet(set);
  std::sort(list.begin(), list.end());

注意：从Qt 5.14开始，范围构造函数可用于Qt的通用容器类，并且应代替此方法使用。
另请参见

fromVector（）

，

toSet（）

和

QSet :: toList（）

。

[static] QList<T> QList::fromStdList(const std::list<T>&list)

返回一个QList对象，列表中包含数据。 QList中元素的顺序与list中的顺序相同。

示例：

  std::list<double> stdlist;
  list.push_back(1.2);
  list.push_back(0.5);
  list.push_back(3.14);

  QList<double> list = QList<double>::fromStdList(stdlist);

注意：从Qt 5.14开始，范围构造函数可用于Qt的通用容器类，并且应代替此方法使用。

另请参见

toStdList（）

和

QVector :: fromStdVector（）

。

[static] QList<T> QList::fromVector(const QVector<T>&vector)

返回带有向量中包含的数据的QList对象。

示例：

  QVector<double> vect;
  vect <<20.0<<30.0<<40.0<<50.0;

  QList<double> list = QVector<T>::fromVector(vect);// list: [20.0, 30.0, 40.0, 50.0]

注意：从Qt 5.14开始，范围构造函数可用于Qt的通用容器类，并且应代替此方法使用。

另请参见

fromSet（）

，

toVector（）

和

QVector :: toList（）

。

T &QList::front()

提供此功能是为了实现STL兼容性。 它等效于first（）。 该列表不能为空。 如果列表可以为空，请在调用此函数之前调用isEmpty（）。

const T &QList::front()const

这是一个重载函数

int QList::indexOf(const T &value,int from =...)const

返回列表中第一个出现的值的索引位置，从索引位置from开始向前搜索。 如果没有匹配项，则返回-1。

示例：

  QList<QString> list;
  list <<"A"<<"B"<<"C"<<"B"<<"A";
  list.indexOf("B");// returns 1
  list.indexOf("B",1);// returns 1
  list.indexOf("B",2);// returns 3
  list.indexOf("X");// returns -1

此函数要求值类型具有operator ==（）的实现。
请注意，QList使用基于0的索引，就像C ++数组一样。 除上述值外，不支持负索引。

另请参见

lastIndexOf（）

和

contains（）

。

void QList::insert(int i,const T &value)

在列表中索引位置i处插入值。 如果i <= 0，则该值位于列表的前面。 如果i> = size（），则将值附加到列表中。

Example:

  QList<QString> list;
  list <<"alpha"<<"beta"<<"delta";
  list.insert(2,"gamma");// list: ["alpha", "beta", "gamma", "delta"]

另参见

append()

, 

prepend()

, 

replace()

, 和

removeAt()

.

QList::iterator QList::insert(QList::iterator before,const T &value)

这是一个重载函数。
在迭代器之前指向的项目前面插入值。 返回指向插入项的迭代器。 注意，调用后传递给该函数的迭代器将无效。 应该使用返回的迭代器代替。

bool QList::isEmpty()const

如果列表不包含任何项目，则返回true；否则，返回true。 否则返回false。

See also 

size()

.

T &QList::last()

返回对列表中最后一项的引用。 该列表不能为空。 如果列表可以为空，请在调用此函数之前调用isEmpty（）。

See also 

constLast()

, 

first()

, and 

isEmpty()

.

const T &QList::last()const

这是一个重载函数。

int QList::lastIndexOf(const T &value,int from =...)const

返回列表中最后一次出现的值的索引位置，从索引位置from开始向后搜索。 如果from为-1（默认值），则搜索从最后一项开始。 如果没有匹配项，则返回-1。

Example:

  QList<QString> list;
  list <<"A"<<"B"<<"C"<<"B"<<"A";
  list.lastIndexOf("B");// returns 3
  list.lastIndexOf("B",3);// returns 3
  list.lastIndexOf("B",2);// returns 1
  list.lastIndexOf("X");// returns -1

此函数要求值类型具有operator ==（）的实现。
请注意，QList使用基于0的索引，就像C ++数组一样。 除上述值外，不支持负索引。

See also 

indexOf()

.

int QList::length()const

此函数与count（）相同。
此功能在Qt 4.5中引入。

See also 

count()

.

QList<T> QList::mid(int pos,int length =-1)const

void QList::move(int from,int to)

将索引位置的项目从移到索引位置。
Example:
在这里插入图片描述
这与insert（to，takeAt（from））相同。此函数假定from和to都至少为0但小于size（）。 为避免失败，请测试from和to两者均至少为0且小于size（）。

See also 

swap()

, 

insert()

, and 

takeAt()

.

void QList::pop_back()

提供此功能是为了实现STL兼容性。 它等效于removeLast（）。 该列表不能为空。 如果列表可以为空，请在调用此函数之前调用isEmpty（）。

void QList::pop_front()

提供此功能是为了实现STL兼容性。 它等效于removeFirst（）。 该列表不能为空。 如果列表可以为空，请在调用此函数之前调用isEmpty（）。

void QList::prepend(const T &value)

在列表的开头插入值。
在这里插入图片描述
这与list.insert（0，value）相同。
如果未共享此列表，则此操作通常非常快（摊销的固定时间），因为QList在其内部缓冲区的两侧预分配了额外的空间，以允许在列表的两端快速增长。

See also 

append()

and 

insert()

.

void QList::push_back(const T &value)

提供此功能是为了实现STL兼容性。 它等效于append（value）。

void QList::push_front(const T &value)

提供此功能是为了实现STL兼容性。 它等效于prepend（value）。

QList::reverse_iterator QList::rbegin()

以相反的顺序返回指向列表中第一项的STL样式反向迭代器。
此功能在Qt 5.6中引入。

See also 

begin()

, 

crbegin()

, and 

rend()

.

QList::const_reverse_iterator QList::rbegin()const

这是一个重载函数。
此功能在Qt 5.6中引入。

int QList::removeAll(const T &value)

删除列表中所有出现的value并返回删除的条目数。
在这里插入图片描述
此函数要求值类型具有operator ==（）的实现。

See also 

removeOne()

, 

removeAt()

, 

takeAt()

, and 

replace()

.

void QList::removeAt(int i)

删除索引位置i处的项目。 我必须是列表中的有效索引位置（即0 <= i <size（））。

See also 

takeAt()

, 

removeFirst()

, 

removeLast()

, and 

removeOne()

.

void QList::removeFirst()

删除列表中的第一项。 调用此函数等效于调用removeAt（0）。 该列表不能为空。 如果列表可以为空，请在调用此函数之前调用isEmpty（）。

See also 

removeAt()

and 

takeFirst()

.

void QList::removeLast()

删除列表中的最后一项。 调用此函数等效于调用removeAt（size（）-1）。 该列表不能为空。 如果列表可以为空，请在调用此函数之前调用isEmpty（）。

See also 

removeAt()

and 

takeLast()

.

bool QList::removeOne(const T &value)

删除列表中第一个出现的值，并在成功时返回true； 否则返回false。
在这里插入图片描述
此函数要求值类型具有operator ==（）的实现。
此功能在Qt 4.4中引入。

See also 

removeAll()

, 

removeAt()

, 

takeAt()

, and 

replace()

.

QList::reverse_iterator QList::rend()

以相反的顺序返回一个STL样式的反向迭代器，该迭代器指向列表中最后一项之后的一个。
此功能在Qt 5.6中引入。

See also 

end()

, 

crend()

, and 

rbegin()

.

QList::const_reverse_iterator QList::rend()const

这是一个重载功能。
此功能在Qt 5.6中引入。

void QList::replace(int i,const T &value)

用值替换索引位置i处的项目。 我必须是列表中的有效索引位置（即0 <= i <size（））。

See also 

operator[]()

and 

removeAt()

.

void QList::reserve(int alloc)

为分配元素保留空间。
如果alloc小于列表的当前大小，则不会发生任何事情。
如果您可以预测要添加多少个元素，请使用此功能避免重复分配QList内部数据。 请注意，保留仅适用于内部指针数组。
此功能在Qt 4.7中引入。

int QList::size()const

返回列表中的项目数。

See also 

isEmpty()

and 

count()

.

bool QList::startsWith(const T &value)const

如果此列表不为空并且其第一项等于value，则返回true；否则，返回true。 否则返回false。
此功能在Qt 4.5中引入。

See also 

isEmpty()

and 

contains()

.

void QList::swap(QList<T>&other)

交换其他与此列表。 此操作非常快，并且永远不会失败。
此功能在Qt 4.8中引入。

void QList::swapItemsAt(int i,int j)

将索引位置i处的项目与索引位置j处的项目进行交换。 此函数假定i和j都至少为0但小于size（）。 为避免失败，请测试i和j至少为0并小于size（）。
在这里插入图片描述
此功能在Qt 5.13中引入。

See also 

move()

.

T QList::takeAt(int i)

删除索引位置i处的项目并返回它。 我必须是列表中的有效索引位置（即0 <= i <size（））。
如果不使用返回值，则removeAt（）会更有效。

See also 

removeAt()

, 

takeFirst()

, and 

takeLast()

.

T QList::takeFirst()

删除列表中的第一项并返回它。 这与takeAt（0）相同。 此函数假定列表不为空。 为避免失败，请在调用此函数之前调用isEmpty（）。
如果未共享此列表，则此操作将花费固定时间。
如果不使用返回值，则removeFirst（）会更有效。

See also 

takeLast()

, 

takeAt()

, and 

removeFirst()

.

T QList::takeLast()

删除列表中的最后一项并返回。 这与takeAt（size（）-1）相同。 此函数假定列表不为空。 为避免失败，请在调用此函数之前调用isEmpty（）。
如果未共享此列表，则此操作将花费固定时间。
如果不使用返回值，则removeLast（）会更有效。

See also 

takeFirst()

, 

takeAt()

, and 

removeLast()

.

QSet<T> QList::toSet()const

返回带有此QList中包含的数据的QSet对象。 由于QSet不允许重复，因此生成的QSet可能小于原始列表。
在这里插入图片描述
注意：从Qt 5.14开始，范围构造函数可用于Qt的通用容器类，并且应代替此方法使用。

See also 

toVector()

, 

fromSet()

, and 

QSet::fromList()

.

std::list<T> QList::toStdList()const

返回带有此QList中包含的数据的std :: list对象。 例：
在这里插入图片描述
注意：从Qt 5.14开始，范围构造函数可用于Qt的通用容器类，并且应代替此方法使用。

See also 

fromStdList()

and 

QVector::toStdVector()

.

QVector<T> QList::toVector()const

返回带有此QList中包含的数据的QVector对象。
在这里插入图片描述
注意：从Qt 5.14开始，范围构造函数可用于Qt的通用容器类，并且应代替此方法使用。

See also 

toSet()

, 

fromVector()

, and 

QVector::fromList()

.

T QList::value(int i)const

返回列表中索引位置i处的值。
如果索引i超出范围，则该函数将返回默认构造的值。 如果确定索引将在范围内，则可以使用at（）来代替，这会稍微快一些。

See also 

at()

and 

operator[]()

.

T QList::value(int i,const T &defaultValue)const

这是一个过载功能。
如果索引i超出范围，则该函数返回defaultValue。

bool QList::operator!=(const QList<T>&other)const

如果other不等于此列表，则返回true；否则，返回false。 否则返回false。
如果两个列表包含相同顺序的相同值，则认为它们相等。
此函数要求值类型具有operator ==（）的实现。

See also 

operator==()

.

QList<T> QList::operator+(const QList<T>&other)const

返回一个列表，其中包含此列表中的所有项目，然后是另一个列表中的所有项目。

See also 

operator+=()

.

QList<T>&QList::operator+=(const QList<T>&other)

将另一个列表的项目追加到此列表，并返回对该列表的引用。

See also 

operator+()

and 

append()

.

QList<T>&QList::operator+=(const T &value)

这是一个过载功能。
将值追加到列表。

See also 

append()

and 

operator<<()

.

QList<T>&QList::operator<<(const QList<T>&other)

将另一个列表的项目追加到此列表，并返回对该列表的引用。

See also 

operator+=()

and 

append()

.

QList<T>&QList::operator<<(const T &value)

这是一个过载功能。
将值追加到列表。

bool QList::operator==(const QList<T>&other)const

如果other等于此列表，则返回true；否则，返回true。 否则返回false。
如果两个列表包含相同顺序的相同值，则认为它们相等。
此函数要求值类型具有operator ==（）的实现。

See also 

operator!=()

.

T &QList::operator[](int i)

返回索引位置i处的项目作为可修改的参考。 我必须是列表中的有效索引位置（即0 <= i <size（））。
如果在当前正在共享的列表上调用此函数，它将触发所有元素的副本。 否则，此功能将以恒定时间运行。 如果不想修改列表，则应使用QList :: at（）。

See also 

at()

and 

value()

.

const T &QList::operator[](int i)const

这是一个重载功能。
Same as 

at().

此函数以恒定时间运行。

标签： Qt QList 详细使用说明
本文转载自: https://blog.csdn.net/u014779536/article/details/111029600
版权归原作者 超级大洋葱806 所有， 如有侵权，请联系我们删除。
登录后发布评论

“QT QList＜T＞介绍与应用、详解、使用说明、官方手册翻译”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

Spring Security 安全权限管理实战指南

服务器 BMC(基板管理控制器,Baseboard Management Controller)认知

如何在 CentOS 6 上使用 RVM 安装 Ruby on Rails

Ubuntu-24.04-live-server-amd64安装界面中文版

Selenium Stealth 安装与使用指南

Locust：压测工具Locust的安装及日常使用

Tuxera 2024 NTFS for Mac 破解版安装、密钥下载与激活教程

文章导航