QSharedMemory Class

メンバ関数ドキュメント

QSharedMemory::QSharedMemory(const QString &key, QObject *parent = nullptr)

指定されたparent と、レガシー・キーがkey に設定された共有メモリ・オブジェクトを構築する。 キーが設定されているため、create() およびattach() 関数を呼び出すことができる。

setKey()、create()、attach()も参照 。

QSharedMemory::QSharedMemory(QObject *parent = nullptr)

この関数は、QSharedMemory() をオーバーロードします。

与えられたparent で共有メモリ・オブジェクトを構築します。共有メモリ・オブジェクトのキーはコンストラクタによって設定されないため、共有メモリ・オブジェクトは、その下にある共有メモリ・セグメントを持ちません。create() またはattach() を使用する前に、setNativeKey() でキーを設定する必要があります。

setNativeKey()も参照 。

QSharedMemory::QSharedMemory(const QNativeIpcKey &key, QObject *parent = nullptr)

これはオーバーロードされた関数です。

指定されたparent と、そのキーがkey に設定された共有メモリ・オブジェクトを構築します。 キーが設定されているため、create() およびattach() 関数を呼び出すことができます。

setNativeKey()、create()、attach()も参照してください 。

[virtual noexcept] QSharedMemory::~QSharedMemory()

デストラクタはキーをクリアし、共有メモリ・オブジェクトをその基礎となる共有メモリ・セグメントから強制的にdetach 取り除きます。この共有メモリ・オブジェクトが共有メモリ・セグメントに接続されている最後のものである場合、detach （）操作によって共有メモリ・セグメントが破棄されます。

detach() およびisAttached()も参照のこと 。

bool QSharedMemory::attach(QSharedMemory::AccessMode mode = ReadWrite)

コンストラクタまたはsetNativeKey() の呼び出しに渡されたキーで識別される共有メモリ・セグメント に、プロセスをアタッチしようとする。アクセスmode は、デフォルトではReadWrite である。ReadOnly にすることもできる。アタッチ操作が成功した場合はtrue を返す。false が返された場合は、error() を呼び出して、どのエラーが発生したかを調べます。共有メモリ・セグメントをアタッチした後、data() を呼び出すと、共有メモリへのポインタを取得できます。

isAttached()、detach()、create()も参照 。

const void *QSharedMemory::constData() const

共有メモリ・セグメントがアタッチされていれば、その内容への const ポインタを返す。そうでない場合は null を返す。この関数が返す値は、detach が発生するまで変更されないので、このポインタを保存しておいても安全である。

unlockメモリ操作がアトミックでない場合は、読み書きする前にlock() で共有メモリをロックしてもよい。

attach() およびcreate()も参照 。

bool QSharedMemory::create(qsizetype size, QSharedMemory::AccessMode mode = ReadWrite)

コンストラクタに渡されたキーまたはsetNativeKey() で設定されたキーを使用して、size バイトの共有メモリ・セグメントを作成し、指定されたアクセスmode で新しい共有メモリ・セグメントにアタッチして、true を返します。キーで識別される共有メモリセグメントが既に存在する場合、アタッチ操作は実行されず、false が返される。戻り値がfalse の場合、error() を呼び出して、どのエラーが発生したかを判断する。

error()も参照のこと 。

void *QSharedMemory::data()

共有メモリ・セグメントがアタッチされていれば、その内容へのポインタを返す。そうでない場合は null を返す。この関数が返す値は、detach が発生するまで変化しないので、このポインタを保存しておいても安全である。

unlockメモリ操作がアトミックでない場合は、読み書きする前にlock() で共有メモリをロックしてもよい。

attach()も参照のこと 。

const void *QSharedMemory::data() const

この関数は data() をオーバーロードする。

bool QSharedMemory::detach()

共有メモリ・セグメントからプロセスをデタッチする。このプロセスが共有メモリ・セグメントに最後にアタッチされたプロセスであった場合、共有メモリ・セグメントはシステムによって解放されます。共有メモリ・セグメントをデタッチした場合、この関数はtrue を返す。この関数がfalse を返す場合は、通常、セグメントがアタッチされていないか、他のプロセスによってロックされていることを意味します。

attach() およびisAttached()も参照のこと 。

QSharedMemory::SharedMemoryError QSharedMemory::error() const

エラーが発生したかどうか、発生した場合はどのエラーであったかを示す値を返す。

errorString() も参照 。

QString QSharedMemory::errorString() const

最後に発生したエラーの説明をテキストで返します。error() がerror value を返した場合、この関数を呼び出して、エラーの内容を示すテキスト文字列を取得する。

error()も参照 。

bool QSharedMemory::isAttached() const

このプロセスが共有メモリ・セグメントにアタッチされている場合、true を返す。

attach() およびdetach() も参照 。

QString QSharedMemory::key() const

この共有メモリにsetKey() で割り当てられたレガシー・キー、またはキーが割り当てられていない場合、またはセグメントがnativeKey() を使用している場合はヌル・キーを返します。キーは、Qt アプリケーションが共有メモリセグメントを識別するために使用する識別子です。

nativeKey() を呼び出すことで、オペレーティング・システムによって使用される、プラットフォーム固有のネイティブ・キーを見つけることができます。

setKey() およびsetNativeKey()も参照して ください。

bool QSharedMemory::lock()

これは、このプロセスによるアクセス用に共有メモリ・セグメントをロックし、true を返すセマフォである。他のプロセスがセグメントをロックした場合、この関数はロックが解放されるまでブロックする。その後、ロックを取得し、true を返します。この関数がfalse を返す場合は、create() またはattach() からの偽リターンを無視したか、setNativeKey() でキーを設定したか、不明なシステム・エラーによりQSystemSemaphore::acquire() が失敗したことを意味する。

unlock()、data()、QSystemSemaphore::acquire()も参照 。

[since 6.6] QNativeIpcKey QSharedMemory::nativeIpcKey() const

この共有メモリ・オブジェクトのキー・タイプを返します。キー・タイプは、オペレーティング・システムが共有メモリ・セグメントを識別するために使用する識別子としてnativeKey() を補完する。

ネイティブ・キーを使用して、Qt によって作成されていない共有メモリ・セグメントにアクセスしたり、Qt 以外のアプリケーションに共有メモリ・アクセスを許可したりすることができます。詳細はネイティブ IPC キーを参照してください。

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

nativeKey() およびsetNativeKey()も参照してください 。

QString QSharedMemory::nativeKey() const

この共有メモリ・オブジェクトの、プラットフォーム固有のネイティブ・キーを返します。ネイティブ・キーは、オペレーティング・システムが共有メモリ・セグメントを識別するために使用する識別子です。

ネイティブ・キーを使用して、Qt によって作成されていない共有メモリ・セグメントにアクセスしたり、Qt 以外のアプリケーションに共有メモリ・アクセスを許可したりすることができます。詳しくはネイティブ IPC キーを参照してください。

setNativeKey() およびnativeIpcKey()も参照してください 。

void QSharedMemory::setKey(const QString &key)

これはオーバーロードされた関数です。

この共有メモリオブジェクトのレガシーkey を設定します。key が現在のキーと同じ場合、この関数は何もせずに戻ります。そうでない場合、共有メモリ・オブジェクトが基礎となる共有メモリ・セグメントにアタッチされていれば、新しいキーを設定する前に、detach 。この関数は、attach （）を実行しません。

レガシー・キーを取得するには、key （）を呼び出します。この関数は

shm.setNativeKey(QSharedMemory::legacyNativeKey(key));

ただし、key()を使用してレガシー・キーを取得できる点は異なる。

key （）、nativeKey （）、isAttached （）も参照 。

[since 6.6] void QSharedMemory::setNativeKey(const QNativeIpcKey &key)

この共有メモリ・オブジェクトに、プラットフォーム固有のネイティブ・キーkey を設定する。key が現在のネイティブ・キーと同じ場合、この関数は何もせずに戻ります。そうでない場合、共有メモリ・オブジェクトが基盤となる共有メモリ・セグメントにアタッチされていれば、新しいキーを設定する前に、そのセグメントからdetach を取得します。この関数は、attach （）を行いません。

この関数は、ネイティブ・キーが他のプロセスから共有された場合に便利です。詳細は「ネイティブIPCキー」を参照。

ポータブル・ネイティブ・キーは、platformSafeKey() を使用して取得できます。

nativeKey() を呼び出すと、ネイティブ・キーを取得できます。

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

nativeKey(),nativeIpcKey(),isAttached()も参照してください 。

void QSharedMemory::setNativeKey(const QString &key, QNativeIpcKey::Type type = QNativeIpcKey::legacyDefaultTypeForOs())

type 型の共有メモリ・オブジェクトに、プラットフォーム固有のネイティブ・キーkey を設定します（type パラメータは Qt 6.6 以降で利用可能です）。key が現在のネイティブ・キーと同じ場合、関数は何もせずに戻ります。そうでない場合、共有メモリオブジェクトが基礎となる共有メモリセグメントにアタッチされていれば、新しいキーを設定する前に、detach 。この関数は、attach （）を実行しない。

この関数は、ネイティブ・キーが他のプロセスから共有された場合に便利であるが、アプリケーションはキー・タイプが他のプロセスが期待するものと一致するように注意しなければならない。詳細は「ネイティブIPCキー」を参照。

ポータブル・ネイティブ・キーは、platformSafeKey()を使用して取得できる。

nativeKey() を呼び出すと、ネイティブ・キーを取得できる。

nativeKey()、nativeIpcKey()、isAttached()も参照 。

qsizetype QSharedMemory::size() const

接続されている共有メモリ・セグメントのサイズを返します。共有メモリ・セグメントがアタッチされていない場合は、0 が返される。

create() およびattach()も参照 。

bool QSharedMemory::unlock()

共有メモリ・セグメントのロックを解放し、そのロックが現在このプロセスによって保持されて いる場合は、true を返す。セグメントがロックされていない場合、またはロックが他のプロセスによって保持されている場合は、何も起こらず、false が返されます。

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