QExplicitlySharedDataPointer Class

メンバ関数ドキュメント

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer()

d ポインタとして nullptr で初期化された 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()

共有オブジェクトへのポインタを返し、これを 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

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

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

このQExplicitlySharedDataPointer インスタンスにother を代入します。

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

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

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

thisの dポインタを o のdポインタにセットし、共有データオブジェクトの参照カウントをインクリメントする。thisの古い共有データオブジェクトの参照カウントをデクリメントする。古い共有データ・オブジェクトの参照カウントが0になったら、古い共有データ・オブジェクトを削除する。