QList Class

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

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

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

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

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

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

例

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

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

通常、この操作は比較的高速です（償却された定数時間）。QList は、リスト・データの先頭に余分なメモリを割り当て、操作のたびにデータを再割り当てしたり移動したりすることなく、その方向に成長させることができます。QList しかし、定数時間のプリペンドが保証されたコンテナ・クラスが必要な場合は、代わりにstd::listを使う。

append() およびinsert()も参照 。

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

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

例

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

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

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

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

emplaceも参照してください 。

リストのインデックス位置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()も参照の こと。

これはオーバーロードされた関数です。

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

インデックス位置i のアイテムをvalue で置き換えます。

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

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

この関数は STL との互換性のために用意されています。prepend(value) と等価。

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

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

このリストのすべての項目の後に、other リストのすべての項目を含むリストを返します。

operator+=()も参照 。

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 に変換可能でなければなりません。

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

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

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

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

size 要素の初期サイズを持つリストを構築します。

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

具体的には

• Qt::Uninitialized を受け付けるコンストラクタがT にある場合、そのコンストラクタが要素の初期化に使用されます；
• そうでない場合、各要素はデフォルトで構築されます。それ以外の場合、各要素はデフォルトで構築されます。些細に構築可能な型（int 、float など）については、これは初期化しないことと同じです。

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

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

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

other のコピーを構築します。

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

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

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

Move-QListインスタンスを構築し、other が指していたのと同じオブジェクトを指すようにします。

[default] 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] 内の要素数に等しくなります。

この関数は、範囲の要素数がこのリストの容量を超えるか、このリストが共有されている場合にのみ、メモリを確保します。

この関数は 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 はリスト内の有効なインデックス位置でなければなりません（つまり、0 <= < ()）。i 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

リストの最初の項目を指す constSTL 形式のイテレータを返します。

begin() およびcend()も参照 。

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

リストの最後の項目の直後を指す constSTL 形式のイテレータを返します。

cbegin() およびend()も参照してください 。

void QList::clear()

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

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

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

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

リストの最初の項目を指す constSTL 形式のイテレータを返します。

begin() およびconstEnd()も参照 。

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

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

この関数は、C++のプレーンな配列を受け付ける関数にリストを渡すのに便利です。

data() およびoperator[]()も参照 。

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

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

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() も参照して ください。

[noexcept] qsizetype QList::count() const

これはオーバーロードされた関数です。

size() と同じ。

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

リストの最初の項目を逆順で指す constSTL 形式の逆順イテレータを返します。

begin()、rbegin()、rend()も参照 。

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

リストの最後の項目の直後を指す constSTL 形式の逆順イテレータを返します。

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

これはオーバーロードされた関数です。

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 を引数としてインプレースで構築されます。

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

[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

インデックス位置from から前方を検索して、リスト内で最初に出現するvalue のインデックス位置を返します。一致する項目がない場合は -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()も参照 。

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

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

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]

[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()も参照 。

[noexcept] qsizetype QList::length() const

size() およびcount() と同じ。

size() およびcount() も参照 。

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 に移動します。

[noexcept] void QList::pop_back()

この関数は STL との互換性のために提供されています。removeLast() と等価です。

[noexcept] void QList::pop_front()

この関数は STL との互換性のために用意されています。removeFirst() と同等です。

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

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

void QList::push_back(QList<T>::rvalue_ref 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

これはオーバーロードされた関数である。

void QList::reserve(qsizetype size)

少なくともsize 要素分のメモリを確保しようとする。

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

どのくらいの容量が必要になるか疑問な場合は、通常、size のような上限値を使用するか、厳密な上限値を使用するとこれよりはるかに大きくなる場合は、最も可能性の高いサイズの高い推定値を使用する方がよい。size が過小評価である場合、予約されたサイズを超えると、リストは必要に応じて大きくなります。

squeeze()、capacity()、resize()も参照 。

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

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

具体的には

• Qt::Uninitialized を受け付けるコンストラクタがT にある場合、そのコンストラクタが要素の初期化に使われる；
• そうでない場合、各要素はデフォルトで構築される。それ以外の場合、各要素はデフォルトで構築されます。些細に構築可能な型（int 、float など）については、これは初期化しないことと同じです。

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

void QList::shrink_to_fit()

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

[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()

list()：リストの最後の項目を削除して返します。この関数は、リストが空でないことを前提とします。失敗を避けるには、この関数を呼び出す前に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==()も参照のこと 。

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<() を実装している必要があります。

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

Move-other をこのQList インスタンスに割り当てる。

[default] 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 は、リスト内の有効なインデックス位置でなければなりません（すなわち、0 <= < ()）。i size

constでない演算子を使うと、QList がディープコピーを行う可能性があることに注意。

at() およびvalue()も参照のこと 。

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

これはオーバーロードされた関数である。

at(i) と同じ。