Класс QList

Класс QList — это шаблонный класс, предоставляющий списки. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Примечание: Все функции в этом классе являются перевходовыми.

Публичные типы

Публичные функции

Статические публичные члены

Связанные нечлены

Подробное описание

QList<T> — один из универсальных классов контейнеров Qt. Он хранит элементы в списке, обеспечивая быстрый индексный доступ и вставки/удаления по индексу.

QList<T>, QLinkedList<T> и QVector<T> предоставляют аналогичные API и функциональность. Часто они взаимозаменяемы, но существуют последствия производительности. Вот обзор вариантов использования:

• QVector обычно является лучшим выбором в качестве отправной точки. QVector<T> обычно обеспечивает лучшую производительность, чем QList<T>, так как QVector<T> всегда хранит свои элементы последовательно в памяти, тогда как QList<T> выделяет элементы в куче, если sizeof(T) <= sizeof(void*) и T объявлен как Q_MOVABLE_TYPE или Q_PRIMITIVE_TYPE с помощью Q_DECLARE_TYPEINFO. См. Преимущества и недостатки использования QList для разъяснения.
• Однако QList используется во всех API Qt для передачи параметров и возврата значений. Используйте QList для взаимодействия с этими API.
• Если вам нужна реальная связанная структура данных, которая гарантирует постоянное время вставки в середину списка и использует итераторы к элементам, а не индексы, используйте QLinkedList.

Примечание: QVector и QVarLengthArray оба гарантируют совместимость с C-массивом. QList не гарантирует этого. Это может быть важно, если ваше приложение должно взаимодействовать с API C.

Примечание: Итераторы в QLinkedList и ссылки на элементы в QList, выделенные в куче, остаются действительными, пока связанные элементы остаются в контейнере. Это не относится к итераторам и ссылкам в QVector и QList, не выделенных в куче.

Внутри QList<T> представляется как массив T, если sizeof(T) <= sizeof(void*) и T объявлен как Q_MOVABLE_TYPE или Q_PRIMITIVE_TYPE с помощью Q_DECLARE_TYPEINFO. В противном случае QList<T> представляется массивом указателей на T, а элементы выделены в куче.

Представление массивом позволяет очень быстро выполнять вставки и индексный доступ. Операции prepend() и append() также очень быстрые, так как QList выделяет память на обоих концах внутреннего массива. (См. Сложность алгоритмов для получения подробной информации.)

Однако, когда вышеуказанные условия не соблюдаются, каждая добавление или вставка нового элемента требует выделения этого элемента в куче, и это выделение каждого элемента сделает QVector лучшим выбором для случаев использования, которые часто добавляют или вставляют элементы, так как QVector может выделить память для многих элементов в одном выделении кучи.

Обратите внимание, что внутренний массив только увеличивается на протяжении всего жизненного цикла списка. Он никогда не уменьшается. Внутренний массив освобождается деструктором и оператором присваивания, когда один список присваивается другому.

Вот пример QList, хранящего целые числа, и QList, хранящего значения QDate:

QList<int> integerList;
QList<QDate> dateList;

Qt включает класс QStringList, который наследуется от QList<QString> и добавляет несколько удобных функций, таких как QStringList::join() и QStringList::filter(). QString::split() создает QStringList из строк.

QList хранит список элементов. Конструктор по умолчанию создает пустой список. Вы можете использовать конструктор списка инициализации для создания списка с элементами:

QList<QString> list = { "one", "two", "three" };

QList предоставляет эти основные функции для добавления, перемещения и удаления элементов: insert(), replace(), removeAt(), move() и swap(). Кроме того, он предоставляет следующие удобные функции: append(), operator<<(), operator+=(), prepend(), removeFirst() и removeLast().

operator<<() позволяет удобно добавлять несколько элементов в список:

list << "four" << "five";

QList использует индексы с нулевой базой, как и C++ массивы. Для доступа к элементу по определённому индексу можно использовать оператор[]. Для не-константных списков оператор[] возвращает ссылку на элемент и может использоваться в левой части присваивания:

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 << Qt::endl;
}

at() может быть быстрее, чем оператор[], потому что он никогда не вызывает глубокое копирование.

Часто требуется удалить элемент из списка и что-то с ним сделать. Для этого QList предоставляет takeAt(), takeFirst() и takeLast(). Вот цикл, который удаляет элементы из списка по одному и вызывает delete на них:

QList<QWidget *> list;
...
while (!list.isEmpty())
    delete list.takeFirst();

Вставка и удаление элементов в начале или конце списка очень быстрые (постоянное время в большинстве случаев), потому что QList предварительно выделяет дополнительное место в начале и в конце внутреннего буфера для быстрой расширяемости.

Если вы хотите найти все вхождения определенного значения в списке, используйте indexOf() или lastIndexOf(). Первый ищет вперед, начиная с заданной позиции индекса, второй — назад. Оба возвращают индекс соответствующего элемента, если он найден; в противном случае возвращают -1. Например:

int i = list.indexOf("Jane");
if (i != -1)
    cout << "First occurrence of Jane is at position " << i << Qt::endl;

Если вам просто нужно проверить, содержит ли список определенное значение, используйте contains(). Если вы хотите узнать, сколько раз определенное значение встречается в списке, используйте count(). Если нужно заменить все вхождения определенного значения другим, используйте replace().

Тип значения QList должен быть типом данных, допускающим присваивание. Это охватывает большинство типов данных, которые обычно используются, но компилятор не позволит вам, например, хранить QWidget как значение; вместо этого храните QWidget *. Некоторые функции имеют дополнительные требования; например, indexOf() и lastIndexOf() ожидают, что тип значения поддерживает operator==(). Эти требования документированы для каждой функции.

Как и другие классы контейнеров, QList предоставляет итераторы в стиле Java (QListIterator и QMutableListIterator) и итераторы в стиле STL (QList::const_iterator и QList::iterator). На практике ими редко пользуются, потому что вы можете использовать индексы в QList. QList реализован таким образом, что прямой доступ по индексу так же быстр, как и использование итераторов.

QList не поддерживает вставку, добавление в начало, добавление в конец или замену с помощью ссылок на свои собственные значения. В результате ваша программа завершится с сообщением об ошибке.

Для максимальной эффективности QList его члены не проверяют входные данные перед использованием. За исключением isEmpty(), члены всегда предполагают, что список не пустой. Члены, принимающие значения индексов в качестве параметров, всегда предполагают, что их параметры значений индексов находятся в допустимом диапазоне. Это означает, что члены QList могут завершиться ошибкой. Если вы определены QT_NO_DEBUG при компиляции, ошибки не будут обнаружены. Если не определены QT_NO_DEBUG, ошибки будут обнаружены с помощью Q_ASSERT() или Q_ASSERT_X() с соответствующим сообщением.

Чтобы избежать ошибок, когда ваш список может быть пустым, вызовите isEmpty() перед вызовом других членов. Если вам нужно передать значение индекса, которое может не находиться в допустимом диапазоне, проверьте, что оно меньше значения, возвращаемого size(), но не меньше 0.

Дополнительные члены

Если T — QByteArray, у этого класса есть несколько дополнительных членов, которые можно использовать. Для получения дополнительной информации см. документацию по QByteArrayList.

Если T — QString, у этого класса есть следующие дополнительные члены: filter, join, removeDuplicates, sort.

Дополнительная информация об использовании контейнеров Qt

Для подробного обсуждения сравнения контейнеров Qt друг с другом и с контейнерами STL см. Understand the Qt Containers.

См. также QListIterator, QMutableListIterator, QLinkedList и QVector.

Документация по типам членов

typedef QList::ConstIterator

Синоним в стиле Qt для QList::const_iterator.

typedef QList::Iterator

Синоним в стиле Qt для QList::iterator.

typedef QList::const_pointer

Тип для const T *. Предоставлен для совместимости со STL.

typedef QList::const_reference

Тип для const T &. Предоставлен для совместимости со STL.

typedef QList::const_reverse_iterator

QList::const_reverse_iterator предоставляет итератор обратного перехода в стиле STL для QList.

Просто синоним для std::reverse_iterator<const_iterator>.

Предупреждение: Итераторы в неявно разделяемых контейнерах не работают точно как STL-итераторы. Следует избегать копирования контейнера, пока итераторы активны в этом контейнере. Для получения дополнительной информации см. проблему итераторов при неявном совместном использовании.

Этот typedef был введен в Qt 5.6.

См. также QList::rbegin(), QList::rend(), QList::reverse_iterator и QList::const_iterator.

typedef QList::difference_type

Тип для ptrdiff_t. Предоставлен для совместимости со STL.

typedef QList::pointer

Тип для T *. Предоставлен для совместимости со STL.

typedef QList::reference

Тип для T &. Предоставлен для совместимости со STL.

typedef QList::reverse_iterator

QList::reverse_iterator предоставляет итератор обратного перехода в стиле STL для QList.

Просто синоним для std::reverse_iterator<iterator>.

Предупреждение: Итераторы в неявно разделяемых контейнерах не работают точно как STL-итераторы. Следует избегать копирования контейнера, пока итераторы активны в этом контейнере. Для получения дополнительной информации см. проблему итераторов при неявном совместном использовании.

Этот typedef был введен в Qt 5.6.

См. также QList::rbegin(), QList::rend(), QList::const_reverse_iterator и QList::iterator.

typedef QList::size_type

Тип для int. Предоставлен для совместимости со STL.

typedef QList::value_type

Тип для T. Предоставлен для совместимости со STL.

Документация по функциям-членам

QList::QList(InputIterator first, InputIterator last)

Создаёт QList с содержимым в диапазоне итераторов [first, last).

Тип значения InputIterator должен быть преобразуем в T.

Эта функция была добавлена в Qt 5.14.

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

Создает список из std::initializer_list, заданной args.

Этот конструктор активен только если компилятор поддерживает C++11 списки инициализации.

Эта функция была добавлена в Qt 4.8.

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

Создает QList, ссылаясь на тот же объект, что и other.

Эта функция была добавлена в Qt 5.2.

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

Создает копию other.

Операция занимает постоянное время, так как QList — неявно разделяемый. Это делает возвращение QList из функции очень быстрым. Если изменён общий экземпляр, он будет скопирован (copy-on-write), что занимает линейное время.

См. также operator=().

QList::QList()

Создаёт пустой список.

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

Присваивает other этому экземпляру QList.

Эта функция была добавлена в Qt 5.2.

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

Присваивает other этому списку и возвращает ссылку на этот список.

QList::~QList()

Удаляет список. Ссылки на значения в списке и все итераторы этого списка становятся недействительными.

void QList::append(const T &value)

Вставляет value в конец списка.

Пример:

QList<QString> list;
list.append("one");
list.append("two");
list.append("three");
// list: ["one", "two", "three"]

Это то же самое, что и list.insert(size(), value).

Если этот список не разделяемый, эта операция обычно очень быстрая (амортизированное постоянное время), так как QList предварительно выделяет дополнительное место в своём внутреннем буфере для быстрого роста в обоих концах списка.

См. также operator<<(), prepend() и insert().

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

Это перегруженная функция.

Добавляет элементы списка value в этот список.

Эта функция была добавлена в Qt 4.5.

См. также operator<<() и operator+=().

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

Возвращает элемент в позиции индекса i в списке. 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

Возвращает константный итератор STL, указывающий на первый элемент в списке.

Эта функция была введена в Qt 5.0.

См. также begin() и cend().

QList::const_iterator QList::cend() const

Возвращает константный итератор STL, указывающий на воображаемый элемент после последнего элемента в списке.

Эта функция была введена в Qt 5.0.

См. также cbegin() и end().

void QList::clear()

Удаляет все элементы из списка.

См. также removeAll().

QList::const_iterator QList::constBegin() const

Возвращает константный итератор STL, указывающий на первый элемент в списке.

См. также begin() и constEnd().

QList::const_iterator QList::constEnd() const

Возвращает константный итератор STL, указывающий на воображаемый элемент после последнего элемента в списке.

См. также constBegin() и end().

const T &QList::constFirst() const

Возвращает константную ссылку на первый элемент в списке. Список не должен быть пустым. Если список может быть пустым, вызовите isEmpty() перед вызовом этой функции.

Эта функция была введена в Qt 5.6.

См. также constLast(), isEmpty() и first().

const T &QList::constLast() const

Возвращает ссылку на последний элемент в списке. Список не должен быть пустым. Если список может быть пустым, вызовите isEmpty() перед вызовом этой функции.

Эта функция была введена в Qt 5.6.

См. также constFirst(), isEmpty() и last().

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

Возвращает true если список содержит вхождение value; в противном случае возвращает false.

Для этой функции тип значения должен иметь реализацию operator==().

См. также indexOf() и count().

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

Возвращает количество вхождений value в списке.

Для этой функции тип значения должен иметь реализацию operator==().

См. также contains() и indexOf().

int QList::count() const

Возвращает количество элементов в списке. Это фактически то же самое, что size().

QList::const_reverse_iterator QList::crbegin() const

Возвращает константный обратный итератор STL, указывающий на первый элемент в списке в обратном порядке.

Эта функция была введена в Qt 5.6.

См. также begin(), rbegin() и rend().

QList::const_reverse_iterator QList::crend() 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

Возвращает true если этот список не пустой и его последний элемент равен value; в противном случае возвращает 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)

Это перегруженная функция.

Удаляет все элементы от begin до (но не включая) end. Возвращает итератор к тому же элементу, на который ссылался end до вызова.

T &QList::first()

Возвращает ссылку на первый элемент в списке. Список не должен быть пустым. Если список может быть пустым, вызовите isEmpty() перед вызовом этой функции.

См. также constFirst(), last() и isEmpty().

const T &QList::first() const

Это перегруженная функция.

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

Возвращает объект QList с данными, содержащимися в set. Порядок элементов в 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 с данными, содержащимися в list. Порядок элементов в 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 с данными, содержащимися в vector.

Пример:

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

Возвращает индекс первого вхождения value в список, начиная поиск с позиции 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 использует индексы с нуля, как и массивы C++. Отрицательные индексы не поддерживаются, за исключением указанного выше случая.

См. также lastIndexOf() и contains().

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

Вставляет value на позицию i в списке. Если i ≤ 0, значение добавляется в начало списка. Если i ≥ size(), значение добавляется в конец списка.

Пример:

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)

Это перегруженная функция.

Вставляет value перед элементом, на который указывает итератор before. Возвращает итератор, указывающий на вставленный элемент. Обратите внимание, что итератор, переданный в функцию, станет недействительным после вызова; вместо него следует использовать возвращенный итератор.

bool QList::isEmpty() const

Возвращает true, если список не содержит элементов; в противном случае возвращает false.

См. также size().

T &QList::last()

Возвращает ссылку на последний элемент в списке. Список не должен быть пустым. Если список может быть пустым, вызовите isEmpty() перед вызовом этой функции.

См. также constLast(), first() и isEmpty().

const T &QList::last() const

Это перегруженная функция.

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

Возвращает индекс последнего вхождения value в список, выполняя поиск назад с позиции from. Если from равно -1 (по умолчанию), поиск начинается с последнего элемента. Возвращает -1, если элемент не найден.

Пример:

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 использует индексы с нуля, как и массивы C++. Отрицательные индексы не поддерживаются, за исключением указанного выше случая.

См. также indexOf().

int QList::length() const

Эта функция идентична count().

Эта функция была добавлена в Qt 4.5.

См. также count().

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

Возвращает подсписок, включающий элементы из этого списка, начиная с позиции pos. Если length равно -1 (по умолчанию), включаются все элементы от pos; в противном случае включаются length элементов (или все оставшиеся, если их меньше, чем length).

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

Перемещает элемент с индексом from на позицию to.

Пример:

QList<QString> list;
list << "A" << "B" << "C" << "D" << "E" << "F";
list.move(1, 4);
// list: ["A", "C", "D", "E", "B", "F"]

Это то же самое, что и insert(to, takeAt(from)). Эта функция предполагает, что и from, и to находятся в диапазоне от 0 до size()-1. Для предотвращения ошибок, проверьте, что оба значения находятся в этом диапазоне.

См. также swap(), insert() и takeAt().

void QList::pop_back()

Эта функция предоставляется для совместимости со STL. Она эквивалентна removeLast(). Список не должен быть пустым. Если список может быть пустым, вызовите isEmpty() перед вызовом этой функции.

void QList::pop_front()

Эта функция предоставляется для совместимости со STL. Она эквивалентна removeFirst(). Список не должен быть пустым. Если список может быть пустым, вызовите isEmpty() перед вызовом этой функции.

void QList::prepend(const T &value)

Вставляет value в начало списка.

Пример:

QList<QString> list;
list.prepend("one");
list.prepend("two");
list.prepend("three");
// list: ["three", "two", "one"]

Это то же самое, что и list.insert(0, value).

Если этот список не общий, эта операция обычно очень быстрая (амортизированное постоянное время), потому что QList предварительно выделяет дополнительное пространство с обеих сторон своего внутреннего буфера для быстрой динамики добавления элементов в начало и конец списка.

См. также append() и 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.

См. также begin(), crbegin() и rend().

QList::const_reverse_iterator QList::rbegin() const

Это перегруженная функция.

Эта функция была добавлена в Qt 5.6.

int QList::removeAll(const T &value)

Удаляет все вхождения value в список и возвращает количество удаленных элементов.

Пример:

QList<QString> list;
list << "sun" << "cloud" << "sun" << "rain";
list.removeAll("sun");
// list: ["cloud", "rain"]

Эта функция требует, чтобы тип значения имел реализацию operator==().

См. также removeOne(), removeAt(), takeAt() и replace().

void QList::removeAt(int i)

Удаляет элемент на позиции i. i должен быть корректным индексом в списке (т.е., 0 ≤ i < size()).

См. также takeAt(), removeFirst(), removeLast() и removeOne().

void QList::removeFirst()

Удаляет первый элемент в списке. Вызов этой функции эквивалентен вызову removeAt(0). Список не должен быть пустым. Если список может быть пустым, вызовите isEmpty() перед вызовом этой функции.

См. также removeAt() и takeFirst().

void QList::removeLast()

Удаляет последний элемент в списке. Вызов этой функции эквивалентен вызову removeAt(size() - 1). Список не должен быть пустым. Если список может быть пустым, вызовите isEmpty() перед вызовом этой функции.

См. также removeAt() и takeLast().

bool QList::removeOne(const T &value)

Удаляет первое вхождение value в список и возвращает true при успехе; в противном случае возвращает false.

Пример:

QList<QString> list;
list << "sun" << "cloud" << "sun" << "rain";
list.removeOne("sun");
// list: ["cloud", "sun", "rain"]

Эта функция требует, чтобы тип значения имел реализацию operator==().

Эта функция была добавлена в Qt 4.4.

См. также removeAll(), removeAt(), takeAt() и replace().

QList::reverse_iterator QList::rend()

Возвращает STL-стиль обратного итератора, указывающего на позицию после последнего элемента в списке в обратном порядке.

Эта функция была добавлена в Qt 5.6.

См. также end(), crend() и rbegin().

QList::const_reverse_iterator QList::rend() const

Это перегруженная функция.

Эта функция была добавлена в Qt 5.6.

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

Заменяет элемент в позиции i на value. i должен быть допустимой позицией индекса в списке (т.е., 0 <= i < size()).

См. также operator[]() и removeAt().

void QList::reserve(int alloc)

Зарезервировать место для alloc элементов.

Если alloc меньше текущего размера списка, ничего не произойдёт.

Используйте эту функцию, чтобы избежать многократной перераспределения внутренней памяти QList, если вы можете предсказать, сколько элементов будет добавлено. Обратите внимание, что резервирование относится только к внутреннему массиву указателей.

Эта функция была добавлена в Qt 4.7.

int QList::size() const

Возвращает количество элементов в списке.

См. также isEmpty() и count().

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

Возвращает true если список не пуст и его первый элемент равен value; в противном случае возвращает false.

Эта функция была добавлена в Qt 4.5.

См. также isEmpty() и contains().

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

Меняет местами список other с этим списком. Эта операция очень быстрая и никогда не завершается ошибкой.

Эта функция была добавлена в Qt 4.8.

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

Меняет местами элемент в позиции i с элементом в позиции j. Эта функция предполагает, что и i, и j не меньше 0, но меньше size(). Чтобы избежать ошибки, проверьте, что и i, и j не меньше 0 и меньше size().

Пример:

QList<QString> list;
list << "A" << "B" << "C" << "D" << "E" << "F";
list.swapItemsAt(1, 4);
// list: ["A", "E", "C", "D", "B", "F"]

Эта функция была добавлена в Qt 5.13.

См. также move().

T QList::takeAt(int i)

Удаляет элемент в позиции i и возвращает его. i должен быть допустимой позицией индекса в списке (т.е., 0 <= i < size()).

Если вам не нужно значение возврата, removeAt() более эффективен.

См. также removeAt(), takeFirst() и takeLast().

T QList::takeFirst()

Удаляет первый элемент в списке и возвращает его. Это то же самое, что и takeAt(0). Эта функция предполагает, что список не пуст. Чтобы избежать ошибки, вызовите isEmpty() перед вызовом этой функции.

Если этот список не совместно используется, эта операция выполняется за постоянное время.

Если вам не нужно значение возврата, removeFirst() более эффективен.

См. также takeLast(), takeAt() и removeFirst().

T QList::takeLast()

Удаляет последний элемент в списке и возвращает его. Это то же самое, что и takeAt(size() - 1). Эта функция предполагает, что список не пуст. Чтобы избежать ошибки, вызовите isEmpty() перед вызовом этой функции.

Если этот список не совместно используется, эта операция выполняется за постоянное время.

Если вам не нужно значение возврата, removeLast() более эффективен.

См. также takeFirst(), takeAt() и removeLast().

QSet<T> QList::toSet() const

Возвращает объект QSet с данными, содержащимися в этом QList. Так как QSet не допускает дубликатов, полученный QSet может быть меньше исходного списка.

Пример:

QStringList list;
list << "Julia" << "Mike" << "Mike" << "Julia" << "Julia";

QSet<QString> set = list.toSet();
set.contains("Julia");  // returns true
set.contains("Mike");   // returns true
set.size();             // returns 2

Примечание: начиная с Qt 5.14, доступны конструкторы диапазона для универсальных контейнерных классов Qt и их следует использовать вместо этого метода.

См. также toVector(), fromSet() и QSet::fromList().

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

Возвращает объект std::list с данными, содержащимися в этом QList. Пример:

QList<double> list;
list << 1.2 << 0.5 << 3.14;

std::list<double> stdlist = list.toStdList();

Примечание: начиная с Qt 5.14, доступны конструкторы диапазона для универсальных контейнерных классов Qt и их следует использовать вместо этого метода.

См. также fromStdList() и QVector::toStdVector().

QVector<T> QList::toVector() const

Возвращает объект QVector с данными, содержащимися в этом QList.

Пример:

QStringList list;
list << "Sven" << "Kim" << "Ola";

QVector<QString> vect = list.toVector();
// vect: ["Sven", "Kim", "Ola"]

Примечание: начиная с Qt 5.14, доступны конструкторы диапазона для универсальных контейнерных классов Qt и их следует использовать вместо этого метода.

См. также toSet(), fromVector() и QVector::fromList().

T QList::value(int i) const

Возвращает значение в позиции индекса i в списке.

Если индекс i находится вне границ, функция возвращает значение, созданное по умолчанию. Если вы уверены, что индекс будет в пределах границ, вы можете использовать at() вместо этого, что немного быстрее.

См. также at() и operator[]().

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

Это перегруженная функция.

Если индекс i находится вне границ, функция возвращает defaultValue.

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

Возвращает true если other не равно этому списку; в противном случае возвращает false.

Два списка считаются равными, если они содержат одинаковые значения в том же порядке.

Для этой функции тип значения должен иметь реализацию operator==().

См. также operator==().

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

Возвращает список, содержащий все элементы этого списка, за которыми следуют все элементы списка other.

См. также operator+=().

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

Добавляет элементы списка other в этот список и возвращает ссылку на этот список.

См. также operator+() и append().

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

Это перегруженная функция.

Добавляет value в список.

См. также append() и operator<<().

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

Добавляет элементы списка other в этот список и возвращает ссылку на этот список.

См. также operator+=() и append().

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

Это перегруженная функция.

Добавляет value в список.

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

Возвращает true если other равно этому списку; в противном случае возвращает false.

Два списка считаются равными, если они содержат одинаковые значения в том же порядке.

Для этой функции тип значения должен иметь реализацию operator==().

См. также operator!=().

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

Возвращает элемент в позиции индекса i как ссылку для изменения. i должен быть допустимой позицией индекса в списке (т.е., 0 <= i < size()).

Если эта функция вызывается для списка, который в данный момент совместно используется, это вызовет копирование всех элементов. В противном случае эта функция выполняется за постоянное время. Если вы не хотите изменять список, используйте QList::at().

См. также at() и value().

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

Это перегруженная функция.

Аналогично at(). Эта функция выполняется за постоянное время.