QSet Class

メンバ関数ドキュメント

新しいアイテムvalue を挿入し、セットへの参照を返す。value がすでにセット内に存在する場合、セットは変更されません。

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

以下同じ unite(other).

operator|()、operator&=()、operator-=()も参照のこと 。

[noexcept] QSet::QSet()

空集合を構築します。

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

QSet::QSet(std::initializer_list<T> list)

イニシャライザーリストlist の各要素のコピーでセットを構築する。

template <typename InputIterator, QtPrivate::IfIsInputIterator<InputIterator> = true> QSet::QSet(InputIterator first, InputIterator last)

イテレータ範囲 [first,last] 内の内容を持つセットを構築する。

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

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

セットの最初のアイテムに位置する constSTL 形式のイテレータを返します。

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

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

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

セットの最初のアイテムに位置する、非 constSTL 形式のイテレータを返します。

qsizetype QSet::capacity() const

セットの内部ハッシュテーブルのバケット数を返す。

この関数の唯一の目的は、QSet のメモリ使用量を微調整する手段を提供することです。一般に、この関数を呼び出す必要はほとんどないでしょう。セット内の項目数を知りたい場合は、size() を呼び出す。

reserve() およびsqueeze()も参照 。

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

セットの最初のアイテムに位置する constSTL 形式のイテレータを返します。

begin() およびcend()も参照してください 。

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

集合の最後の項目の後の虚数項目を指す、STL 形式のイテレータを返します。

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

void QSet::clear()

セットからすべての要素を削除します。

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

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

セットの最初のアイテムに位置する constSTL 形式のイテレータを返します。

begin() およびconstEnd()も参照してください 。

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

集合の最後の項目の後の虚数項目を指す、STL 形式のイテレータを返します。

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

QSet<T>::const_iterator QSet::constFind(const T &value) const

セット内の項目value に位置する定数イテレータを返す。セットに項目value が含まれていない場合、この関数はconstEnd() を返します。

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

bool QSet::contains(const QSet<T> &other) const

セットにother セットのすべての項目が含まれている場合はtrue を返し、そうでない場合はfalse を返す。

insert()、remove()、find()も参照 。

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

セットに項目value が含まれていればtrue を返し、含まれていなければ false を返す。

insert()、remove() およびfind()も参照 。

qsizetype QSet::count() const

size() と同じ。

bool QSet::empty() const

セットが空の場合、true を返します。この関数は STL との互換性のために提供されています。これはisEmpty() と同等です。

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

集合の最後のアイテムの後の架空のアイテムに位置する constSTL 形式のイテレータを返します。

constEnd() およびbegin()も参照してください 。

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

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

セットの最後のアイテムの後の架空のアイテムを指す、非 constSTL 形式のイテレータを返します。

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

イテレータ位置pos にある項目をセットから削除し、セットの次の項目に位置するイテレータを返す。

remove() とは異なり、この関数は、QSet の内部データ構造を決してリハッシュさせません。これは、反復処理中に安全に呼び出すことができ、セット内の項目の順序に影響を与えないことを意味する。

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

QSet<T>::const_iterator QSet::find(const T &value) const

セット内の項目value に位置する定数イテレータを返す。セットに項目value が含まれていない場合、この関数はconstEnd() を返します。

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

QSet<T>::iterator QSet::find(const T &value)

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

セット内の項目value に位置する非定数のイテレータを返します。セットに項目value が含まれていない場合、この関数はend() を返します。

QSet<T>::iterator QSet::insert(const T &value)

value がまだセット内にない場合、項目value をセットに挿入し、挿入された項目を指すイテレータを返します。

operator<<()、remove()、contains()も参照 。

[since 6.1] QSet<T>::iterator QSet::insert(QSet<T>::const_iterator it, const T &value)

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

value がまだセット内にない場合、アイテムvalue をセットに挿入し、挿入されたアイテムを指すイテレータを返します。

イテレータit は無視されます。

この関数は STL との互換性のために提供されています。

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

operator<<(),remove(),contains()も参照してください 。

QSet<T> &QSet::intersect(const QSet<T> &other)

このセットから、other セットに含まれないすべての項目を削除します。このセットへの参照が返されます。

intersects()、operator&=()、unite() およびsubtract()も参照 。

bool QSet::intersects(const QSet<T> &other) const

このセットがother と少なくとも1つの共通項目を持つ場合、true を返す。

contains() およびintersect()も参照 。

bool QSet::isEmpty() const

集合に要素がない場合はtrue を返し、そうでない場合は false を返す。

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

bool QSet::remove(const T &value)

項目value の出現回数をすべてセットから削除する。項目が実際に削除された場合は true を返し、そうでない場合はfalse を返します。

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

[since 6.1] template <typename Pred> qsizetype QSet::removeIf(Pred pred)

この集合から、述語pred がtrue を返すすべての要素を削除します。もしあれば、削除された要素の数を返します。

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

void QSet::reserve(qsizetype size)

セットの内部ハッシュテーブルが少なくともsize のバケットで構成されていることを保証する。

この関数は、巨大なセットを構築する必要があり、再割り当ての繰り返しを避けたいコードに便利です。例えば

QSet<QString> set;
set.reserve(20000);
for (int i = 0; i < 20000; ++i)
    set.insert(values[i]);

size size は素数である必要はない。なぜなら は内部的に素数を使うからだ。 が過小評価である場合、最悪なのは が少し遅くなることである。QSet size QSet

一般的には、この関数を呼び出す必要はほとんどないだろう。QSet内部ハッシュ・テーブルが自動的に縮小したり拡大したりするので、メモリをあまり浪費することなく良好なパフォーマンスが得られる。

squeeze() およびcapacity()も参照の こと。

qsizetype QSet::size() const

セットに含まれる項目の数を返します。

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

void QSet::squeeze()

メモリを節約するために、セットの内部ハッシュテーブルのサイズを小さくする。

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

reserve() およびcapacity()も参照 。

QSet<T> &QSet::subtract(const QSet<T> &other)

other セットに含まれるすべての項目をこのセットから削除します。このセットへの参照を返します。

operator-=()、unite() およびintersect()も参照してください 。

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

このセットをother と入れ替える。この操作は非常に速く、失敗することはない。

QSet<T> &QSet::unite(const QSet<T> &other)

other 、このセットにまだ入っていない各項目が、このセットに挿入される。このセットへの参照が返されます。

operator|=()、intersect() およびsubtract()も参照 。

QList<T> QSet::values() const

セットの要素を含む新しいQList を返します。QList の要素の順序は未定義です。

この関数は、線形時間で新しいリストを作成します。constBegin() からconstEnd() までを繰り返し実行することで、時間とメモリの使用を避けることができます。

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

other セットがこのセットと等しくない場合はtrue を返し、そうでない場合はfalse を返す。

2つの集合が同じ要素を含む場合は等しいとみなされる。

この関数は、operator==() を実装する値型を必要とします。

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

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

以下同じ intersect(other).

operator&()、operator|=()、operator-=()も参照のこと 。

QSet<T> &QSet::operator&=(const T &value)

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

と同じである。 intersect(other)と同じで、other をシングルトンvalue を含む集合とみなす。

QSet<T> &QSet::operator-=(const QSet<T> &other)

以下同じ subtract(other).

operator-()、operator|=()、operator&=()も参照のこと 。

QSet<T> &QSet::operator-=(const T &value)

項目value が見つかった場合、それをセットから削除し、セットへの参照を返します。value がセットに含まれていない場合は、何も削除されません。

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

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

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

2つの集合が同じ要素を含む場合、等しいとみなされる。

この関数は、operator==() を実装する値型を必要とします。

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