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;
// リスト：["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は要素を初期化しないように試みます。

具体的には

• T にQt::Uninitialized を受け付けるコンストラクタがある場合、そのコンストラクタを使用して要素を初期化します；
• そうでない場合、各要素はデフォルトで構築されます。それ以外の場合、各要素はデフォルトで構築されます。些細に構築可能な型（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

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

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

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