QExplicitlySharedDataPointer Class

メンバ関数ドキュメント

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer()

nullptr をd ポインタとして初期化された QExplicitlySharedDataPointer を構築します。

[explicit noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(T *data)

d ポインタが data に設定された QExplicitlySharedDataPointer を構築し、data の参照カウントをインクリメントします。

[noexcept] template <typename X> QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(const QExplicitlySharedDataPointer<X> &o)

このコピー・コンストラクタは、o を異なる型の明示的共有データ・ポインタとすることができるが、互換性のある共有データ・オブジェクトを持つことができるという点で異なる。

デフォルトでは、o （X * 型）のdポインタは暗黙のうちにT * 型に変換される。この変換結果はthisの dポインタとして設定され、共有データオブジェクトの参照カウントがインクリメントされる。

しかし、QExplicitlySharedDataPointer ヘッダーを含む前にマクロQT_ENABLE_QEXPLICITLYSHAREDDATAPOINTER_STATICCAST が定義された場合、o のdポインターは static_cast を経てT * 型に変換される。そして、キャストの結果がこの dポインタとして設定され、共有データ・オブジェクトの参照カウントがインクリメントされる。

    QExplicitlySharedDataPointer<Base> base(new Base);
    QExplicitlySharedDataPointer<Derived> derived(base); // !!! DANGER !!!

Qt 5.4 以降、キャストはデフォルトで無効になっています。Qt 5.4以降、キャストはデフォルトで無効になっています。QT_ENABLE_QEXPLICITLYSHAREDDATAPOINTER_STATICCAST マクロを定義することで、キャストを有効に戻すことができ、（この機能に依存していた）古いコードを修正せずにコンパイルできるようになります。

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(const QExplicitlySharedDataPointer<T> &o)

この標準的なコピーコンストラクタは、thisの dポインタを o のdポインタに設定し、共有データオブジェクトの参照カウントをインクリメントする。

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(QExplicitlySharedDataPointer<T> &&o)

Move-QExplicitlySharedDataPointerインスタンスを構築し、o が指していたのと同じオブジェクトを指すようにする。

QExplicitlySharedDataPointer::~QExplicitlySharedDataPointer()

共有データ・オブジェクトの参照カウントを減少させる。参照カウントが0になると、共有データオブジェクトは削除される。その後、破棄されます。

[protected] T *QExplicitlySharedDataPointer::clone()

現在のデータのディープコピーを作成し、返す。この関数は、新しいコピーを作成するために、参照カウントが 1 より大きいときにdetach() から呼び出される。この関数はnew 演算子を使用し、T 型のコピーコンストラクタを呼び出します。

使い方の説明はQSharedDataPointer<T>::clone() を参照。

[noexcept] const T *QExplicitlySharedDataPointer::constData() const

共有データオブジェクトへの const ポインタを返します。

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

[noexcept] T *QExplicitlySharedDataPointer::data() const

共有データオブジェクトへのポインタを返します。

void QExplicitlySharedDataPointer::detach()

共有データ・オブジェクトの参照カウントが1より大きい場合、この関数は共有データ・オブジェクトのディープ・コピーを作成し、その dポインタをコピーに設定する。

QSharedDataPointer のメンバが行うような書き込み操作時の自動コピーはQExplicitlySharedDataPointer では行わないため、このクラスのメンバ関数のどこでも自動的に detach() が呼び出されることはありません。コードのあちこちでdetach()を呼び出している場合は、代わりにQSharedDataPointer 。

[noexcept, since 6.0] T *QExplicitlySharedDataPointer::get() const

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

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

[noexcept, since 6.0] void QExplicitlySharedDataPointer::reset(T *ptr = nullptr)

この dポインタを ptr にセットし、ptr がnullptr でない場合、ptr の参照カウントをインクリメントする。古い共有データ・オブジェクトの参照カウントがデクリメントされ、参照カウントが 0 になるとオブジェクトが削除されます。

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

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

この明示的に共有されたデータ・ポインターをother と交換する。この操作は非常に高速で、失敗することはない。

[noexcept] T *QExplicitlySharedDataPointer::take()

共有オブジェクトへのポインタを返し、this を nullptr にリセットする（つまり、この関数はthisのd ポインタを nullptr にセットする）。

[noexcept] bool QExplicitlySharedDataPointer::operator bool() const

thisのd ポインタがNULL でない場合、true を返す。

[noexcept] bool QExplicitlySharedDataPointer::operator!() const

thisの dポインタが nullptr の場合、true を返す。

T &QExplicitlySharedDataPointer::operator*() const

共有データ・オブジェクトのメンバーへのアクセスを提供します。

[noexcept] T *QExplicitlySharedDataPointer::operator->()

共有データ・オブジェクトのメンバーへのアクセスを提供します。

[noexcept] T *QExplicitlySharedDataPointer::operator->() const

共有データオブジェクトのメンバへの定数アクセスを提供する。

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

Move-other をこのQExplicitlySharedDataPointer インスタンスに割り当てる。

[noexcept] QExplicitlySharedDataPointer<T> &QExplicitlySharedDataPointer::operator=(T *o)

thisのd ポインタを o に設定し、o の参照カウントをインクリメントする。thisの古い共有データ・オブジェクトの参照カウントがデクリメントされる。古い共有データ・オブジェクトの参照カウントが0になると、古い共有データ・オブジェクトは削除される。

[noexcept] QExplicitlySharedDataPointer<T> &QExplicitlySharedDataPointer::operator=(const QExplicitlySharedDataPointer<T> &o)

thisの dポインタを o のdポインタに設定し、共有データ・オブジェクトの参照カウントをインクリメントする。thisの古い共有データオブジェクトの参照カウントがデクリメントされる。古い共有データ・オブジェクトの参照カウントが0になると、古い共有データ・オブジェクトは削除される。