QList介绍

FROM: http://apps.hi.baidu.com/share/detail/33517814 

今天做项目时，需要用到QList来存储一组点。为此，我对QList类的说明进行了如下翻译。

QList是一种表示链表的模板类。
QList是Qt的一种泛型容器类。它以链表方式存储一组值，并能对这组数据进行快速索引，
还提供了快速插入和删除等操作。
QList、QLinkedList和QVector提供的操作极其相似：
* 对大多数操作来说，我们用QList就可以了。其API是基于索引（index）的，因此用起来比QLinkedList更方便（QLinkedList的API是基于迭代器的）。QList比QVector更快，这是由它
们在内存中的存储方式决定的。
* 需要使用QLinkedList的地方：
* 需要使用QVector的地方：元素的储存位置彼此相邻。

QList表示为一组指向被存储元素的数组。（例外，如果T本身就是指针类型，或者是size不
大于指针类型的基本类型，或者是Qt的共享类，那么QList会直接在指针数组中存储这些元素
。）元素个数小于1000的QList能够很快地实现在链表中间插入操作，以及快速的查找操作。此
外，由于QList在链表两端都预先分配了内存，因此实现prepend()和append()操作都很快。
注意：对于size比指针大的共享类，使用QVector会更好。

以下是两个分别存储int型数据和QDate类型数据的链表：
QList intList;
QList dateList;
对于字符串链表，Qt提供了QStringList类。它继承自QList，但还提供了一些其他便于使用字符
串的函数：QStringList::join()、QStringList::find()、QStringList::split()。

QList以链表形式存储一组元素。默认为空链表，我们可以使用<<操作符添加元素：
QList list;
list << "one" << "two" << "three"; // list: ["one", "two", "three"]
QList提供了一系列添加、移动、删除元素的操作：insert(), replace(), removeAt(), swap()
。此外，它还提供了便于操作的函数：append(), prepend(), removeFirst(), removeLast()。
QList与C++中数组的索引方式一样，都是从0开始的。我们可以使用［］操作符来访问位于索引值
处的元素。对于非const链表，操作符[]返回的是该元素的引用，并且返回值可以用途左操作数。
if ( list[0] == "Bob" )
   list[0] = "Robert";
由于QList是以指针数组的形式实现的，该操作能够很快地实现（时间复杂度为常数）。对于只读
访问，我们可以用at()函数实现访问：
for ( int i=0; i!=list.size(); ++i )
{
   if ( list.at(i) == "Jane" )
   { cout << "Found Jane at position:" << i<< endl;}
}
at()操作比操作符[]更快，因为它不需要深度复制(deep copy)。
QList的一个常用操作是，从链表中取出一个元素（元素不再在链表之中），并对该元素进行操作。
QList提供了以下操作来实现此功能：takeAt()、takeFirst()、takeLast()。以下是一个示例：
QList list;
...
while ( !list.isEmpty() )
   deleta list.takeFirst();
由于QList在链表两端都预先分配了缓存以应对链表两端的快速添加操作，这样就使得在QList的
两端插入或删除元素变得非常地快。
如果需要找出某个值在链表中出现的位置，我们可以使用indexOf()、lastIndexOf()函数来实现。
前者进行前向查找，而后者则进行反向查找。两者都会在找到匹配元素后返回该元素的索引值。若
没有找到匹配元素，则返回-1。例如：
int i = indexOf("Jane");
if ( i!=-1 )
   cout << "First occurance of Jane is at position" << i << endl;

如果仅仅是想判断链表中是否包含某一值，我们可以使用函数contains()。如果希望知道某一值在
链表中的出现次数，使用count()函数。如果要替换掉链表中所有值与某一值相同的元素，使用
replace()。

QList的值必须是可数的类型。这包含了我们常用的大多数类型。但是，如果我们存储QWidget类型
的话，编译器也不会通知我们出错了。但是，我们应该使用QWidget *，而不是QWidget。此外，一
些函数还作出了其它限制，比如：indexOf()和lastIndexOf()操作要求值的类型能进行“==”操作。

与其他容器一样，QList也提供了Java形式的迭代器（QListIterator和QMutableListIterator）。
以及STL形式的迭代器（QList::const_iterator和QList::iterator）。实际上，由于可通过索引值
来访问元素，我们很少使用这些迭代器。使用索引值访问元素的速度与迭代器相差无几。

为了提高效率，QList的成员函数在使用前并不会验证其参数是否有效。除isEmpty()函数外，其它
成员函数都会假定该容器为非空容器；使用索引值(index)进行操作的成员函数都会假定其索引值参
数是在有效范围内的。这就意味着，QList在有些时候会出错。如果在编译时，我们定义了QT_NO_DEBUG
，编译过程中就不会检测这些错误。如果没有定义QT_NO_DEBUG，我们可以利用Q_ASSERT()或者
Q_ASSERT_X()加上一些合理的信息来实现错误检测。

我们可以在调用其他函数之前先调用isEmpty()函数判断链表是否为空，以避免对空链表进行错
误操作。而对于以索引值index为参数的成员函数，我们还需要判断该索引值是否位于有效范围
内。