QWeakPointer Class

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

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 互換性を確保するために提供されています。

このスマートポインタが、実装定義による所有者ベースの順序において、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も参照してください 。

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

この弱いポインタのインスタンスを、other と入れ替えます。この操作は非常に高速で、失敗することはありません。

QSharedPointer<T> QWeakPointer::toStrongRef() const

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

この関数は、共有オブジェクトへの有効な強参照を取得できない場合があるため、返されたオブジェクトに対して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()」も参照してください 。

QWeakPointer::operator bool() const

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

if (weakref) { /*...*/ }

なお、弱い参照の性質上、QWeakPointer が参照するポインタはいつでもnullptr になる可能性があるため、この関数の戻り値は呼び出しごとにtrueからfalseに変化する可能性があります。

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