QWeakPointer Class

メンバ関数ドキュメント

このスマートポインタが、実装で定義された所有者ベースの順序でother より前にある場合にのみ、true を返します。この順序付けは、2つのスマートポインタが両方とも空であるか、または（見かけの型とポインタが異なっていても）両方とも同じオブジェクトを所有している場合に等価であるとみなされます。

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

owner_equalも参照して ください。

このスマートポインタとother が所有権を共有している場合に限り、true を返します。

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

owner_before およびowner_hashも参照してください 。

[noexcept, since 6.7] size_t QWeakPointer::owner_hash() const

このスマートポインタオブジェクトのオーナーベースのハッシュ値を返します。(owner_equal)等しいスマートポインタを比較すると、同じオーナーベースのハッシュを持つことになります。

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

owner_equalも参照してください 。

QWeakPointer::QWeakPointer()

何も指していない QWeakPointer を作成します。

QWeakPointer::QWeakPointer(const QSharedPointer<T> &other)

other によって参照されるポインタへの弱い参照を保持する QWeakPointer を作成します。

T がこのクラスのテンプレート・パラメータの派生型である場合、QWeakPointer は自動キャストを行います。そうでない場合は、コンパイラ・エラーが発生します。

[noexcept] QWeakPointer::QWeakPointer(const QWeakPointer<T> &other)

other によって参照されるポインタへの弱い参照を保持する QWeakPointer を作成します。

T がこのクラスのテンプレート・パラメータの派生型である場合、QWeakPointer は自動キャストを行います。そうでない場合は、コンパイラ・エラーが発生します。

QWeakPointer::~QWeakPointer()

このQWeakPointer オブジェクトを破棄する。このオブジェクトが参照するポインタは削除されません。

void QWeakPointer::clear()

このQWeakPointer オブジェクトをクリアし、ポインタへの参照を削除する。

bool QWeakPointer::isNull() const

このオブジェクトがnullptr を参照している場合、true を返す。

弱参照の性質上、QWeakPointer が参照するポインタはいつでもnullptr になる可能性があるため、この関数から返される値は、呼び出しのたびに偽から真に変わる可能性があることに注意してください。

QSharedPointer<T> QWeakPointer::lock() const

toStrongRef() と同じ。

この関数は、std::weak_ptrとのAPI互換性のために提供される。

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

この弱いポインターのインスタンスをother と交換する。この操作は非常に高速で、失敗することはない。

QSharedPointer<T> QWeakPointer::toStrongRef() const

この弱い参照を強い参照に昇格させ、その参照を保持するQSharedPointer オブジェクトを返す。QSharedPointer に昇格させる際、この関数はオブジェクトがすでに削除されているかどうかを確認します。削除されていない場合、この関数は共有オブジェクトへの参照カウントを増やし、削除されないようにします。

この関数は、共有オブジェクトへの有効な強い参照の取得に失敗する可能性があるため、返されたオブジェ クトに対してQSharedPointer::isNull() を呼び出して、変換が成功したかどうかを常に検証する必要があります。

例えば、以下のコードでは、保持されていたQWeakPointer を強参照に昇格させ、成功した場合は保持されていた整数の値を表示します：

    QWeakPointer<int>weakref;// ...  QSharedPointer<int>strong=weakref.toStrongRef();if(strong)        qDebug() << "The value is:" << *strong;
   その他        qDebug() << "The value has already been deleted";

QSharedPointer::QSharedPointer()も参照のこと 。

bool QWeakPointer::operator bool() const

含まれるポインタがnullptr でない場合はtrue を返す。この関数は、if-constructs のように使用するのに適している：

    if (weakref) { ... }

弱参照の性質上、QWeakPointer が参照するポインタはいつでもnullptr になる可能性があるため、この関数から返される値は、呼び出すたびに真から偽に変わる可能性があることに注意してください。

isNull()も参照のこと 。

bool QWeakPointer::operator!() const

このオブジェクトがnullptr を参照している場合、true を返す。 この関数はif-constructs のように使用するのに適している：

    if (!weakref) { ... }

弱参照の性質上、QWeakPointer が参照するポインタはいつでもnullptr になる可能性があるため、この関数から返される値は、呼び出しのたびに false から true に変わる可能性があることに注意してください。

isNull()も参照のこと 。

QWeakPointer<T> &QWeakPointer::operator=(const QSharedPointer<T> &other)

このオブジェクトにother のポインタを共有させる。現在のポインタ参照は破棄されるが、削除はされない。

T がこのクラスのテンプレート・パラメーターの派生型である場合、QWeakPointer は自動的にキャストを行います。そうでない場合は、コンパイラー・エラーが発生します。

[noexcept] QWeakPointer<T> &QWeakPointer::operator=(const QWeakPointer<T> &other)

このオブジェクトにother のポインタを共有させる。現在のポインタ参照は破棄されるが、削除はされない。

T がこのクラスのテンプレート・パラメーターの派生型である場合、QWeakPointer は自動的にキャストを行います。そうでない場合は、コンパイラー・エラーが発生します。