QSet Class

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

[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

セットの最初の要素の位置にある、STL スタイルのconstイテレータを返します。

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

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

セットの最初の要素の位置にある、非constのSTLスタイルのイテレータを返します。

qsizetype QSet::capacity() const

セットの内部ハッシュテーブルに含まれるバケットの数を返します。

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

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

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

セットの最初の要素の位置にある、STL スタイルのconstイテレータを返します。

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

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

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

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

void QSet::clear()

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

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

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

セットの最初の要素の位置にある、STL スタイルのconstイテレータを返します。

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

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

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

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

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

セット内の要素value に位置する const イテレータを返します。セットに要素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

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

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

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

セットの最後の要素の直後に位置する架空の要素を指す、非constのSTLスタイルのイテレータを返します。

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 に位置する const イテレータを返します。セットに項目value が含まれていない場合、この関数はconstEnd() を返します。

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

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

セット内の要素value の位置に配置された非constイテレータを返します。セットに要素value が含まれていない場合、この関数はend()を返します。

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

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

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

[since 6.1] QSet<T>::iterator QSet::insert(T &&value)

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

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

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

[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 と入れ替えます。この操作は非常に高速で、失敗することはありません。

other セットに含まれておらず、かつこのセットにもまだ含まれていない各項目が、このセットに挿入されます。このセットへの参照が返されます。

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

QList<T> QSet::values() const &

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

この関数は、線形時間で新しいリストを作成します。これに伴う時間とメモリの使用は、constBegin() からconstEnd() への反復処理を行うことで回避できます。

[since 6.12] QList<T> QSet::values() &&

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

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

「同じ」として intersect(other)。

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

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

次と同じです intersect(other)、他の要素を、単元集合value を含む集合とみなす場合。

「同じ」 unite(other)。

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

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

「同じ」として subtract(other)。

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

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

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

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

新しい項目 `value ` をセットに追加し、セットへの参照を返します。もし `value ` がすでにセット内に存在する場合、セットは変更されません。

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