QList Class

メンバ関数のドキュメント

[constexpr noexcept default] QList::QList()

空のリストを作成します。

resize()も参照してください 。

[explicit] QList::QList(qsizetype size)

初期サイズがsize 個の要素を持つリストを作成します。

要素はデフォルトの初期化値で初期化されます。

resize()も参照してください 。

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

args で指定された std::initializer_list からリストを構築します。

template <typename InputIterator, QList<T>::if_input_iterator<InputIterator> = true> QList::QList(InputIterator first, InputIterator last)

イテレータの範囲 [first,last) 内の要素を含むリストを作成します。

InputIterator の値型は、T に変換可能でなければなりません。

制約

InputIterator がLegacyInputIterator の要件を満たしている場合にのみ、オーバーロード解決の対象となります。

QList::QList(qsizetype size, QList<T>::parameter_type value)

初期サイズがsize 個の要素を持つリストを作成します。各要素はvalue で初期化されます。

resize() およびfill()も参照してください 。

[since 6.8] QList::QList(qsizetype size, Qt::Initialization)

初期サイズがsize 個の要素を持つリストを作成します。

QListは、要素を初期化しないよう試みます。

具体的には：

• T にQt::Uninitialized を受け入れるコンストラクタが存在する場合、そのコンストラクタを使用して要素を初期化します。
• そうでない場合、各要素はデフォルトコンストラクタによって初期化されます。簡単に構築可能な型（int 、float など）の場合、これは要素を初期化しないことと同等です。

この関数は Qt 6.8 で導入されました。

resizeForOverwrite()も参照してください 。

[implicit] QList::QList(const QList<T> &other)

other のコピーを作成します。

QListは暗黙的に共有されているため、この操作は定数時間で行われます。これにより、関数からQListを返す処理は非常に高速になります。共有されているインスタンスが変更された場合、そのインスタンスはコピーされます（コピー・オン・ライト）が、これには線形時間がかかります。

operator=()も参照してください 。

[implicit] QList::QList(QList<T> &&other)

QListのインスタンスをムーブコンストラクタで生成し、other が指していたのと同じオブジェクトを指すようにします。

[implicit] QList::~QList()

リストを削除します。

void QList::append(QList<T>::parameter_type value)

リストの最後に「value 」を追加します。

例：

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

これは、resize(size() + 1) を呼び出し、リストの新しい最後の要素にvalue を代入するのと同じです。

QList は通常、必要以上のメモリを割り当てているため、毎回リスト全体を再割り当てすることなく拡張できることから、この操作は比較的高速です。

operator<<()、prepend()、およびinsert()も参照してください 。

[since 6.0] void QList::append(QList<T> &&value)

value リストの項目を、このリストの末尾に移動します。

この関数は Qt 6.0 で導入されました。

operator<<() およびoperator+=()も参照してください 。

void QList::append(QList<T>::rvalue_ref value)

例：

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

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

value リストの項目を、このリストに追加します。

operator<<() およびoperator+=()も参照してください 。

[since 6.6] QList<T> &QList::assign(std::initializer_list<T> l)

このリストの内容を、l の要素のコピーに置き換えます。

このリストのサイズは、l 内の要素数と同じになります。

この関数は、l 内の要素数がこのリストの容量を超える場合、またはこのリストが共有されている場合にのみ、メモリを割り当てます。

この関数は Qt 6.6 で導入されました。

[since 6.6] template <typename InputIterator, QList<T>::if_input_iterator<InputIterator> = true> QList<T> &QList::assign(InputIterator first, InputIterator last)

このリストの内容を、イテレータの範囲 [first,last) 内の要素のコピーで置き換えます。

このリストのサイズは、範囲 [first,last) 内の要素数と同じになります。

この関数は、範囲内の要素数がこのリストの容量を超える場合、またはこのリストが共有されている場合にのみ、メモリを割り当てます。

制約

InputIterator がLegacyInputIterator の要件を満たしている場合にのみ、オーバーロードの解決に関与します。

この関数は Qt 6.6 で導入されました。

[since 6.6] QList<T> &QList::assign(qsizetype n, QList<T>::parameter_type t)

このリストの内容を、t のn 個のコピーに置き換えます。

このリストのサイズはn と同じになります。

n がリストの容量を超える場合、またはこのリストが共有されている場合にのみ、この関数はメモリを割り当てます。

この関数は Qt 6.6 で導入されました。

[noexcept] QList<T>::const_reference QList::at(qsizetype i) const

リスト内のインデックス位置i にある項目を返します。

i i は、リスト内の有効なインデックス位置でなければなりません（つまり、0 <= < ())。size

value() およびoperator[]()も参照してください 。

QList<T>::reference QList::back()

この関数は、STLとの互換性を確保するために提供されています。これは、last() と同等です。

[noexcept] QList<T>::const_reference QList::back() const

QList<T>::iterator QList::begin()

リストの最初の要素を指すSTL形式のイテレータを返します。

関連項目： constBegin() およびend()。

[noexcept] QList<T>::const_iterator QList::begin() const

qsizetype QList::capacity() const

再割り当てを強制せずにリストに格納できる項目の最大数を返します。

この関数の唯一の目的は、QList のメモリ使用量を微調整する手段を提供することです。一般的に、この関数を呼び出す必要はほとんどありません。リスト内の項目数を知りたい場合は、size()を呼び出してください。

関連項目： reserve() およびsqueeze()。

[noexcept] QList<T>::const_iterator QList::cbegin() const

リストの最初の要素を指す、STL スタイルのconstイテレータを返します。

関連項目： begin() およびcend()。

[noexcept] QList<T>::const_iterator QList::cend() const

リストの最後の要素の直後に位置する、STL スタイルのconstイテレータを返します。

関連項目： cbegin() およびend()。

void QList::clear()

リストからすべての要素を削除します。

このリストが共有されていない場合、capacity() は保持されます。余分な容量を解放するには、squeeze() を使用してください。

関連項目： resize() およびsqueeze()。

[noexcept] QList<T>::const_iterator QList::constBegin() const

リストの最初の要素を指す、STL スタイルのconstイテレータを返します。

関連項目： begin() およびconstEnd()。

[noexcept] QList<T>::const_pointer QList::constData() const

リストに格納されているデータへのconstポインタを返します。このポインタを使用して、リスト内の項目にアクセスできます。

この関数は、主に、通常のC++配列を受け取る関数にリストを渡す際に役立ちます。

関連項目： data() およびoperator[]()。

[noexcept] QList<T>::const_iterator QList::constEnd() const

リストの最後の要素の直後を指す、STL スタイルのconstイテレータを返します。

関連項目： constBegin() およびend()。

[noexcept] const T &QList::constFirst() const

リストの最初の要素へのconst参照を返します。この関数は、リストが空ではないことを前提としています。

constLast()、isEmpty()、およびfirst()も参照してください 。

[noexcept] const T &QList::constLast() const

リストの最後の要素へのconst参照を返します。この関数は、リストが空ではないことを前提としています。

constFirst()、isEmpty()、およびlast()も参照してください 。

[noexcept] template <typename AT> bool QList::contains(const AT &value) const

リストに `value` が含まれている場合は `true ` を返し、そうでない場合は `false` を返します。

この関数を使用するには、値型が `operator==()` の実装を持っている必要があります。

indexOf() およびcount()も参照してください 。

[noexcept] template <typename AT = T> qsizetype QList::count(const AT &value) const

リスト内の `value ` の出現回数を返します。

この関数を使用するには、値型が `operator==()` の実装を備えている必要があります。

contains() およびindexOf()も参照してください 。

[constexpr noexcept] qsizetype QList::count() const

size() と同じです。

[noexcept] QList<T>::const_reverse_iterator QList::crbegin() const

リストの最初の要素を逆順で指す、STL スタイルのconst 逆イテレータを返します。

関連項目： begin()、rbegin()、rend()も参照してください 。

[noexcept] QList<T>::const_reverse_iterator QList::crend() const

リストの最後の要素の直後を指す、STL 形式のconst リバースイテレータを、逆順で返します。

関連項目: ` end()`、`rend()`、および `rbegin()`。

QList<T>::pointer QList::data()

リストに格納されているデータへのポインタを返します。このポインタを使用すると、リスト内の項目にアクセスしたり、変更したりすることができます。

例：

QList<int> list(10);
int *data = list.data();
for (qsizetype i = 0; i < 10; ++i)
    data[i] = 2 * i;

この関数は、主に、通常のC++配列を受け取る関数にリストを渡す際に役立ちます。

関連項目: ` constData()` および `operator[]()`。

[noexcept] QList<T>::const_pointer QList::data() const

void QList::detach()

このQList のデータが、他のインスタンスと共有されなくなるようにします。

template <typename... Args> QList<T>::iterator QList::emplace(qsizetype i, Args &&... args)

位置i に新しい要素を挿入して、コンテナを拡張します。この新しい要素は、args を構築引数として使用して、その場で構築されます。

新しい要素へのイテレータを返します。

例:

QList<QString> list{"a", "ccc"};
list.emplace(1, 2, 'b');
// list: ["a", "bb", "ccc"]

emplaceBackも参照してください 。

template <typename... Args> QList<T>::iterator QList::emplace(QList<T>::const_iterator before, Args &&... args)

イテレータ `before` が指す項目の前に、新しい要素を作成します。この新しい要素は、args を構築引数として使用して、その場で構築されます。

新しい要素へのイテレータを返します。

コンテナの末尾に新しい要素を追加します。この新しい要素は、args を構築引数として使用して、その場（インプレース）で構築されます。

新しい要素への参照を返します。

例：

QList<QString>list{"one", "two"};
list.emplaceBack(3, 'a');
qDebug() << list;
// リスト: ["one", "two", "aaa"]

また、返された参照を使用して、新しく作成されたオブジェクトにアクセスすることも可能です:

QList<QString> list;
auto &ref = list.emplaceBack();
ref = "one";
// list: ["one"]

これは、list.emplace(list.size(),args) と同じです。

emplaceも参照してください 。

[noexcept] bool QList::empty() const

この関数は、STLとの互換性を確保するために提供されています。これはisEmpty()と同等であり、リストが空の場合はtrue を返し、それ以外の場合はfalse を返します。

QList<T>::iterator QList::end()

リストの最後の要素の直後を指すSTL形式のイテレータを返します。

関連項目： begin() およびconstEnd()。

[noexcept] QList<T>::const_iterator QList::end() const

bool QList::endsWith(QList<T>::parameter_type value) const

このリストが空ではなく、その最後の要素が `value` と等しい場合、`true ` を返します。それ以外の場合は `false` を返します。

isEmpty() およびlast()も参照してください 。

QList<T>::iterator QList::erase(QList<T>::const_iterator pos)

イテレータ `pos ` が指す要素をリストから削除し、リスト内の次の要素へのイテレータを返します（`end()` となる場合もあります）。

要素の削除後もリストの容量は維持され、割り当てられたメモリ量は減りません。余分な容量を削減し、可能な限り多くのメモリを解放するには、squeeze() を呼び出してください。

関連項目： insert() およびremove()。

QList<T>::iterator QList::erase(QList<T>::const_iterator begin, QList<T>::const_iterator end)

begin からend までのすべての要素を削除します（ 自体は削除されません）。呼び出し前にend が参照していたのと同じ要素へのイテレータを返します。

要素の削除後もリストの容量は維持され、割り当てられたメモリ量は減りません。余分な容量を削減し、可能な限り多くのメモリを解放するには、squeeze() を呼び出してください。

QList<T> &QList::fill(QList<T>::parameter_type value, qsizetype size = -1)

リスト内のすべての項目に `value ` を割り当てます。size が -1（デフォルト）以外の場合、事前にリストのサイズを `size ` に変更します。

例:

QList<QString> list(3);
list.fill("Yes");
// list: ["Yes", "Yes", "Yes"]

list.fill("oh", 5);
// list: ["oh", "oh", "oh", "oh", "oh"]

resize()も参照してください 。

T &QList::first()

リストの最初の項目への参照を返します。この関数は、リストが空ではないことを前提としています。

last()、isEmpty()、およびconstFirst()も参照してください 。

[since 6.0] QList<T> QList::first(qsizetype n) const

このリストの最初のn 個の要素を含む部分リストを返します。

この関数は Qt 6.0 で導入されました。

last() およびsliced()も参照してください 。

[noexcept] const T &QList::first() const

QList<T>::reference QList::front()

この関数は、STLとの互換性を確保するために提供されています。これは、first() と同等です。

[noexcept] QList<T>::const_reference QList::front() const

[noexcept] template <typename AT> qsizetype QList::indexOf(const AT &value, qsizetype from = 0) const

リスト内の「value 」が最初に現れる位置を、インデックス位置from から順方向に検索して返します。一致する項目がない場合は-1を返します。

例:

QList<QString> 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==()` の実装を持っている必要があります。

lastIndexOf() およびcontains()も参照してください 。

リストのインデックス位置i にvalue を挿入します。i が0の場合、その値はリストの先頭に追加されます。i がsize()の場合、その値はリストの末尾に追加されます。

例：

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

リストが大きい場合、この操作は低速になる可能性があります（線形時間）。これは、インデックスi 以上のすべての要素を、メモリ上で 1 位置分先へ移動させる必要があるためです。高速なinsert() 関数を提供するコンテナクラスが必要な場合は、代わりに std::list を使用してください。

関連項目： append()、prepend()、およびremove()を参照してください 。

QList<T>::iterator QList::insert(QList<T>::const_iterator before, qsizetype count, QList<T>::parameter_type value)

イテレータbefore が指す項目の前に、value のcount 個のコピーを挿入します。挿入された項目の先頭を指すイテレータを返します。

イテレータ `before` が指す項目の前に、value を挿入します。挿入された項目を指すイテレータを返します。

QList<T>::iterator QList::insert(qsizetype i, qsizetype count, QList<T>::parameter_type value)

リストのインデックス位置i に、value のcount 個のコピーを挿入します。

例:

QList<double> list = {2.718, 1.442, 0.4342};
list.insert(1, 3, 9.9);
// list: [2.718, 9.9, 9.9, 9.9, 1.442, 0.4342]

[constexpr noexcept] bool QList::isEmpty() const

リストのサイズが 0 の場合は `true ` を返し、それ以外の場合は `false` を返します。

size() およびresize()も参照してください 。

T &QList::last()

リストの最後の項目への参照を返します。この関数は、リストが空ではないことを前提としています。

first()、isEmpty()、およびconstLast()も参照してください 。

[since 6.0] QList<T> QList::last(qsizetype n) const

このリストの最後のn 個の要素を含む部分リストを返します。

この関数は Qt 6.0 で導入されました。

first() およびsliced()も参照してください 。

[noexcept] const T &QList::last() const

[noexcept] template <typename AT> qsizetype QList::lastIndexOf(const AT &value, qsizetype from = -1) const

インデックス位置from から逆方向に検索し、リスト内で値value が最後に現れるインデックス位置を返します。from が -1（デフォルト）の場合、検索は最後の要素から開始されます。一致する要素がない場合は -1 を返します。

例：

QList<QString> 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==()` の実装が必要です。

indexOf()も参照してください 。

[constexpr noexcept] qsizetype QList::length() const

size() およびcount() と同様です。

size() およびcount()も参照してください 。

この関数は、リストが理論上保持できる要素の最大数を返します。実際には、システムで使用可能なメモリ量によって制限されるため、この数ははるかに小さくなる場合があります。

これらの関数は Qt 6.8 で導入されました。

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

このリストのpos の位置から始まる要素を含む部分リストを返します。length が-1（デフォルト）の場合、pos 以降のすべての要素が含まれます。それ以外の場合は、length 個の要素（または、length 個未満の要素がある場合は残りのすべての要素）が含まれます。

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

インデックス位置from にある項目を、インデックス位置to に移動します。

from なお、to は範囲内である必要があります。

たとえば、最初の要素をリストの末尾に移動するには：

QList<int>list={1, 2, 3};
list.move(0,list.size()- 1);
qDebug() << list; // Prints "QList(2, 3, 1)"

[noexcept] void QList::pop_back()

この関数は、STLとの互換性を確保するために提供されています。これは、removeLast() と同等です。

[noexcept] void QList::pop_front()

この関数は、STLとの互換性を確保するために提供されています。これは、removeFirst() と同等です。

リストの先頭に「value 」を挿入します。

例：

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

これは list.insert(0,value) と同じです。

通常、この操作は比較的高速です（平均定数時間）。QList は、リストデータの先頭に追加のメモリを割り当てることができ、操作のたびにデータを再割り当てしたり移動させたりすることなく、その方向にリストを拡張できます。ただし、先頭への挿入が定数時間で保証されるコンテナクラスが必要な場合は、代わりにstd::listを使用してください。それ以外の場合は、QList を優先してください。

append() およびinsert()も参照してください 。

void QList::push_back(QList<T>::parameter_type value)

この関数は、STLとの互換性を確保するために提供されています。これは、append(value) と同等です。

void QList::push_back(QList<T>::rvalue_ref value)

この関数は、STLとの互換性を確保するために用意されています。これは、prepend(value) と同等です。

QList<T>::reverse_iterator QList::rbegin()

リストの最初の要素を指す、STL形式の逆方向イテレータを、逆順で返します。

関連項目： begin()、crbegin()、およびrend()。

[noexcept] QList<T>::const_reverse_iterator QList::rbegin() const

void QList::remove(qsizetype i, qsizetype n = 1)

インデックス位置i から始まるn 個の要素をリストから削除します。

要素の削除後もリストの容量は維持され、割り当てられたメモリ量は減りません。余分な容量を削減し、可能な限り多くのメモリを解放するには、squeeze() を呼び出してください。

関連項目： insert()、replace()、およびfill()。

template <typename AT = T> qsizetype QList::removeAll(const AT &t)

リストから、t と等しいすべての要素を削除します。削除された要素がある場合は、その数を返します。

要素の削除を行っても、リストの容量は維持され、割り当てられたメモリ量は減りません。余分な容量を削減し、可能な限り多くのメモリを解放するには、squeeze() を呼び出してください。

removeOne()も参照してください 。

void QList::removeAt(qsizetype i)

インデックス位置i にある要素を削除します。これは

remove(i);

要素の削除を行っても、リストの容量は維持され、割り当てられたメモリ量は減りません。余分な容量を削減し、可能な限り多くのメモリを解放するには、squeeze() を呼び出してください。

remove()も参照してください 。

[noexcept] void QList::removeFirst()

リストの先頭にある要素を削除します。この関数を呼び出すことは、remove(0)を呼び出すことと同じです。リストは空であってはなりません。リストが空になってよい場合は、この関数を呼び出す前にisEmpty()を呼び出してください。

要素の削除を行っても、リストの容量は維持され、割り当てられたメモリ量は減りません。余分な容量を削減し、可能な限り多くのメモリを解放するには、squeeze() を呼び出してください。

remove()、takeFirst()、およびisEmpty()も参照してください 。

[since 6.1] template <typename Predicate> qsizetype QList::removeIf(Predicate pred)

述語 `pred ` が真を返すすべての要素をリストから削除します。削除された要素がある場合は、その数を返します。

この関数は Qt 6.1 で導入されました。

removeAll()も参照してください 。

[noexcept] void QList::removeLast()

リストの最後の要素を削除します。この関数を呼び出すことは、remove(size() - 1)を呼び出すことと同じです。リストは空であってはなりません。リストが空であってもよい場合は、この関数を呼び出す前にisEmpty()を呼び出してください。

要素の削除を行っても、リストの容量は維持され、割り当てられたメモリ量は減りません。余分な容量を削減し、可能な限り多くのメモリを解放するには、squeeze() を呼び出してください。

remove()、takeLast()、removeFirst()、およびisEmpty()も参照してください 。

template <typename AT = T> bool QList::removeOne(const AT &t)

リストから、t と等しい最初の要素を削除します。実際に要素が削除されたかどうかを返します。

要素の削除を行っても、リストの容量は維持され、割り当てられたメモリ量は減りません。余分な容量を削減し、可能な限り多くのメモリを解放するには、squeeze() を呼び出してください。

removeAll()も参照してください 。

QList<T>::reverse_iterator QList::rend()

リストの最後の要素の直後を指す、逆順のSTLスタイルの逆イテレータを返します。

関連項目： end()、crend()、およびrbegin()。

[noexcept] QList<T>::const_reverse_iterator QList::rend() const

インデックス位置i にある項目を、value に置き換えます。

i i はリスト内の有効なインデックス位置でなければなりません（つまり、0 <= < ())。size

operator[]() およびremove()も参照してください 。

void QList::reserve(qsizetype size)

少なくともsize 個の要素分のメモリを割り当てようとします。

リストのサイズが事前に分かっている場合は、再割り当てやメモリの断片化を防ぐために、この関数を呼び出すべきです。また、リストのサイズを頻繁に変更する場合も、パフォーマンスが向上する可能性があります。

必要な容量が不明確な場合は、通常、size を上限として指定するか、厳密な上限がこの値よりもはるかに大きい場合は、最も可能性の高いサイズの上限推定値を使用することをお勧めします。size が過小評価されている場合、予約されたサイズを超えるとリストは必要に応じて拡大されます。その結果、最も楽観的な推定値よりも大きな割り当てが行われ、それを引き起こした操作の速度が低下する可能性があります。

関連項目： squeeze()、capacity()、resize()。

リストのサイズを `size` に設定します。`size ` が現在のサイズより大きい場合、要素はリストの末尾に追加されます。新しい要素は、デフォルトのコンストラクタで生成された値、または `c` で初期化されます。`size ` が現在のサイズより小さい場合、要素はリストの末尾から削除されます。

このリストが共有されていない場合、`capacity()` の値は保持されます。余分な容量を解放するには、`squeeze()` を使用してください。

これらの関数は Qt 6.0 で導入されました。

size()も参照してください 。

[since 6.8] void QList::resizeForOverwrite(qsizetype size)

リストのサイズをsize に設定します。size が現在のサイズより小さい場合、要素は末尾から削除されます。size が現在のサイズより大きい場合、要素は末尾に追加されます。QList を指定すると、これらの新しい要素の初期化を行わないよう試みます。

具体的には：

• T にQt::Uninitialized を受け入れるコンストラクタがある場合、そのコンストラクタを使用して要素を初期化します。
• そうでない場合、各要素はデフォルトコンストラクタによって初期化されます。単純なコンストラクタを持つ型（int 、float など）の場合、これは初期化を行わないことと同等です。

この関数は Qt 6.8 で導入されました。

void QList::shrink_to_fit()

この関数は、STLとの互換性を確保するために提供されています。これは、squeeze() と同等です。

[constexpr noexcept] qsizetype QList::size() const

リスト内の項目の数を返します。

isEmpty() およびresize()も参照してください 。

[since 6.0] QList<T> QList::sliced(qsizetype pos, qsizetype n) const

このリストの、位置pos から始まる、n 個の要素を含む部分リストを返します。

この関数は Qt 6.0 で導入されました。

first() およびlast()も参照してください 。

[since 6.0] QList<T> QList::sliced(qsizetype pos) const

このリストのpos の位置から末尾までの要素を含む部分リストを返します。

この関数は Qt 6.0 で導入されました。

first() およびlast()も参照してください 。

void QList::squeeze()

アイテムの保存に不要なメモリを解放します。

この関数の唯一の目的は、QList のメモリ使用量を微調整する手段を提供することです。通常、この関数を呼び出す必要はほとんどありません。

reserve() およびcapacity()も参照してください 。

bool QList::startsWith(QList<T>::parameter_type value) const

このリストが空ではなく、かつその最初の要素が `value` と等しい場合は `true ` を返し、そうでない場合は `false` を返します。

isEmpty() およびfirst()も参照してください 。

[noexcept] void QList::swap(QList<T> &other)

このリストをother と入れ替えます。この操作は非常に高速で、失敗することはありません。

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

インデックス位置i にある要素と、インデックス位置j にある要素を入れ替えます。この関数は、i とj の両方が 0 以上かつsize() 未満であることを前提としています。失敗を防ぐため、i とj の両方が 0 以上かつsize() 未満であることを確認してください。

T QList::takeAt(qsizetype i)

インデックス位置i にある要素を取り出し、それを返します。

以下と同等です。

T t = at(i);
remove(i);
return t;

takeFirst() およびtakeLast()も参照してください 。

QList<T>::value_type QList::takeFirst()

リストの先頭要素を削除し、それを返します。この関数は、リストが空ではないことを前提としています。エラーを防ぐには、この関数を呼び出す前に `isEmpty()` を呼び出してください。

takeLast() およびremoveFirst()も参照してください 。

QList<T>::value_type QList::takeLast()

リストの最後の要素を削除し、それを返します。この関数は、リストが空ではないことを前提としています。エラーを防ぐには、この関数を呼び出す前に `isEmpty()` を呼び出してください。

戻り値を使用しない場合は、removeLast() の方が効率的です。

takeFirst() およびremoveLast()も参照してください 。

T QList::value(qsizetype i) const

リストのインデックス位置i にある値を返します。

インデックス `i ` が範囲外の場合、この関数はデフォルト構築された値を返します。i が範囲内であることが確実な場合は、代わりに `at()` を使用すると、処理が若干高速になります。

at() およびoperator[]()も参照してください 。

T QList::value(qsizetype i, QList<T>::parameter_type defaultValue) const

インデックス `i ` が範囲外の場合、この関数は `defaultValue` を返します。

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

other がこのリストと等しくない場合はtrue を返し、それ以外の場合はfalse を返します。

2つのリストは、同じ順序で同じ値を含んでいる場合に等しいとみなされます。

この関数を使用するには、値型に `operator==()` の実装が存在する必要があります。

operator==()も参照してください 。

このリストのすべての要素と、other リストのすべての要素を連結したリストを返します。

operator+=()も参照してください 。

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

other リストの項目をこのリストに追加し、このリストへの参照を返します。

operator+() およびappend()も参照してください 。

[since 6.0] QList<T> &QList::operator+=(QList<T> &&other)

この関数は Qt 6.0 で導入されました。

operator+() およびappend()も参照してください 。

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

リストに `value ` を追加します。

append() およびoperator<<()も参照してください 。

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

append() およびoperator<<()も参照してください 。

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

このリストがotherよりも字句的に小さい場合、true を返します。そうでない場合は、false を返します。

この関数を使用するには、値型が `operator<()` の実装を持っている必要があります。

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

value をリストに追加し、このリストへの参照を返します。

append() およびoperator+=()も参照してください 。

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

リストに `other ` を追加し、そのリストへの参照を返します。

[since 6.0] QList<T> &QList::operator<<(QList<T> &&other)

この関数は Qt 6.0 で導入されました。

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

append() およびoperator+=()も参照してください 。

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

このリストが、otherよりも辞書順で小さいか等しい場合は、true を返します。それ以外の場合は、false を返します。

この関数を使用するには、値型が `operator<()` の実装を持っている必要があります。

[implicit] QList<T> &QList::operator=(QList<T> &&other)

other をこのQList インスタンスに割り当てます。

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

other をこのリストに割り当て、このリストへの参照を返します。

QList<T> &QList::operator=(std::initializer_list<T> args)

args 内の値のコレクションを、このQList インスタンスに割り当てます。

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

other がこのリストと等しい場合はtrue を返し、そうでない場合はfalse を返します。

2つのリストは、同じ順序で同じ値を含んでいる場合に等しいとみなされます。

この関数を使用するには、値型にoperator==() の実装が存在する必要があります。

operator!=()も参照してください 。

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

このリストがotherより辞書順で大きい場合はtrue を返し、そうでない場合はfalse を返します。

この関数を使用するには、値型が `operator<()` の実装を持っている必要があります。

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

このリストがotherよりも辞書的に大きい、または等しい場合はtrue を返し、そうでない場合はfalse を返します。

この関数を使用するには、値型が `operator<()` の実装を持っている必要があります。

QList<T>::reference QList::operator[](qsizetype i)

インデックス位置i にある項目を、変更可能な参照として返します。

i i は、リスト内の有効なインデックス位置でなければなりません（つまり、0 <= < ())。size

非 const 演算子を使用すると、QList がディープコピーを行う場合があることに注意してください。

at() およびvalue()も参照してください 。

[noexcept] QList<T>::const_reference QList::operator[](qsizetype i) const

(i) と同様です。