QWeakPointer Class

メンバ関数ドキュメント

このスマートポインタが、実装で定義された所有者ベースの順序でother より前にある場合に限り、true を返します。この順序付けは、2つのスマートポインタが両方とも空であるか、同じオブジェクトを所有している場合（見かけの型やポインタが異なっていても）、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 になる可能性があることに注意。したがって、この関数から返される値は、呼び出しのたびに false から true に変わる可能性がある。

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;
    else
        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 は自動キャストを行います。そうでない場合は、コンパイラー・エラーが発生します。