QSharedMemory 类提供对共享内存段的访问。 更多...
头: | #include <QSharedMemory> |
qmake: | QT += core |
Since: | Qt 4.4 |
继承: | QObject |
该类在 Qt 4.4 引入。
enum | AccessMode { ReadOnly, ReadWrite } |
enum | SharedMemoryError { NoError, PermissionDenied, InvalidSize, KeyError, AlreadyExists, …, UnknownError } |
QSharedMemory (const QString & key , QObject * parent = nullptr) | |
QSharedMemory (QObject * parent = nullptr) | |
virtual | ~QSharedMemory () |
bool | attach (QSharedMemory::AccessMode mode = ReadWrite) |
const void * | constData () const |
bool | create (int size , QSharedMemory::AccessMode mode = ReadWrite) |
void * | data () |
const void * | data () const |
bool | detach () |
QSharedMemory::SharedMemoryError | error () const |
QString | errorString () const |
bool | isAttached () const |
QString | key () const |
bool | lock () |
QString | nativeKey () const |
void | setKey (const QString & key ) |
void | setNativeKey (const QString & key ) |
int | size () const |
bool | unlock () |
QSharedMemory 提供对多线程和进程共享内存段的访问。它还为单线程 (或进程) 提供锁定内存的独占访问手段。
当使用此类时,要意识到以下平台差异:
记住锁定共享内存采用 lock () 在读写共享内存之前,和记住释放锁采用 unlock () 在完成后。
QSharedMemory 自动销毁共享内存段,当从段分离最后 QSharedMemory 实例时,且不保留段引用。
警告: QSharedMemory 以特定 Qt 方式改变键,除非另外指定。与非 Qt 应用程序的互操作的达成是通过首先创建默认共享内存采用 QSharedMemory(),然后设置本机键采用 setNativeKey ()。当使用本机键时,不保护对共享内存的多次访问 (例如:无法 lock ()) 且应该使用用户定义机制来达成这种保护。
常量 | 值 | 描述 |
---|---|---|
QSharedMemory::ReadOnly
|
0
|
共享内存段是只读的。不允许写入共享内存段。尝试写入采用 ReadOnly 创建的共享内存段,会导致程序中止。 |
QSharedMemory::ReadWrite
|
1
|
允许读写共享内存段。 |
常量 | 值 | 描述 |
---|---|---|
QSharedMemory::NoError
|
0
|
没有出现错误。 |
QSharedMemory::PermissionDenied
|
1
|
操作失败,因为调用者没有所需权限。 |
QSharedMemory::InvalidSize
|
2
|
创建操作失败,因为请求大小无效。 |
QSharedMemory::KeyError
|
3
|
操作失败,因为键无效。 |
QSharedMemory::AlreadyExists
|
4
|
A create () 操作失败,因为具有指定键的共享内存段已存在。 |
QSharedMemory::NotFound
|
5
|
An attach () 失败,因为找不到具有指定键的共享内存段。 |
QSharedMemory::LockError
|
6
|
试图 lock () 共享内存段失败,因为 create () 或 attach () 失败和返回 false,或因为发生系统错误在 QSystemSemaphore::acquire (). |
QSharedMemory::OutOfResources
|
7
|
A create () 操作失败,因为没有足够内存可用于填充请求。 |
QSharedMemory::UnknownError
|
8
|
发生其它事情且很糟糕。 |
构造共享内存对象采用给定 parent 并将其键设为 key 。因为有设置键,其 create () 和 attach () 函数可以被调用。
另请参阅 setKey (), create (),和 attach ().
此函数重载 QSharedMemory()。
构造共享内存对象采用给定 parent 。由于构造函数未设置共享内存对象的键,因此,共享内存对象没有附加底层共享内存段。必须设置键采用 setKey () 或 setNativeKey () 先于 create () 或 attach () 可以使用。
另请参阅 setKey ().
[虚拟]
QSharedMemory::
~QSharedMemory
()
析构函数清零键,强制共享内存对象 detach 从其底层共享内存段。若此共享内存对象是连接到共享内存段的最后一个, detach () 操作会销毁共享内存段。
另请参阅 detach () 和 isAttached ().
试图将进程附加到共享内存段,通过传递给构造函数的键标识或调用
setKey
() 或
setNativeKey
()。访问
mode
is
ReadWrite
默认情况下。它还可以为
ReadOnly
。返回
true
若附加操作成功。若返回 false,调用
error
() 以确定发生何种错误。在附加共享内存段后,可以获得共享内存的指针通过调用
data
().
另请参阅 isAttached (), detach (),和 create ().
返回共享内存段内容的 const 指针,若有附加一个的话。否则,返回 null。记得锁定共享内存采用 lock () 在读写共享内存之前,和记住释放锁采用 unlock () 在完成后。
创建共享内存段
size
字节采用传递给构造函数的键,设置采用
setKey
() 或设置采用
setNativeKey
(),然后附加到新共享内存段采用给定访问
mode
并返回
true
。若由键标识的共享内存段已存在,不履行附加操作和
false
被返回。当返回值为
false
,调用
error
() 以确定发生何种错误。
另请参阅 error ().
返回共享内存段内容的 const 指针,若有附加一个的话。否则,返回 null。记得锁定共享内存采用 lock () 在读写共享内存之前,和记住释放锁采用 unlock () 在完成后。
另请参阅 attach ().
此函数重载 data()。
从共享内存段分离进程。若这是附加到共享存储段的最后进程,则共享存储段由系统释放 (即:销毁内容)。函数返回
true
若它分离了共享内存段。若它返回
false
,通常意味着段未被附加或被另一进程锁定。
另请参阅 attach () 和 isAttached ().
返回指示是否发生错误的值,且若如此,指示错误是什么。
另请参阅 errorString ().
返回最后发生错误的文本描述。若 error () 返回 错误值 ,调用此函数以获取描述错误的文本字符串。
另请参阅 error ().
返回
true
若此进程被附加到共享内存段。
返回的键赋值采用 setKey () 到此共享内存,或 null 键若尚未赋值键,或段使用的是 nativeKey ()。键是 Qt 应用程序用来标识共享内存段的标识符。
可以找到由操作系统使用的本机、特定平台键,通过调用 nativeKey ().
另请参阅 setKey () 和 setNativeKey ().
这是锁供此进程访问的共享内存段的信号量,并返回
true
。若另一进程已锁定段,此函数阻塞直到锁被释放为止。然后,获取锁并返回
true
。若此函数返回
false
,意味着已忽略的 false 返回来自
create
() 或
attach
(),已设置键采用
setNativeKey
() 或
QSystemSemaphore::acquire
() 失败由于未知系统错误。
另请参阅 unlock (), data (),和 QSystemSemaphore::acquire ().
返回用于此共享内存对象的本机、特定平台键。本机键是操作系统用于标识共享内存段的标识符。
可以使用本机键访问 Qt 尚未创建的共享内存段,或将共享内存访问授予非 Qt 应用程序。
该函数在 Qt 4.8 引入。
另请参阅 setKey () 和 setNativeKey ().
设置平台无关 key 为此共享内存对象。若 key 与当前键相同,函数将什么都不做而返回。
可以调用 key () 以检索平台无关键。在内部, QSharedMemory 将此键转换成平台特定键。若改为调用 nativeKey (),将获得特定平台的转换键。
若将共享内存对象附加到底层共享内存段,它将 detach 从其,在设置新键之前。此函数不做 attach ().
另请参阅 key (), nativeKey (),和 isAttached ().
设置特定平台本机 key 为此共享内存对象。若 key 与当前本机键相同,函数将什么都不做而返回。若只想为段赋值键,应调用 setKey () 代替。
可以调用 nativeKey () 以检索本机键。若有赋值本机键,调用 key () 将返回 null 字符串。
若将共享内存对象附加到底层共享内存段,它将 detach 从其,在设置新键之前。此函数不做 attach ().
应用程序将不可移植,若设置本机键。
该函数在 Qt 4.8 引入。
另请参阅 nativeKey (), key (),和 isAttached ().
返回共享内存段的附加大小。若未附加共享内存段,返回 0。
注意: 段大小可能大于请求大小,被传递给 create ().
释放共享内存段锁并返回
true
,若锁目前由此进程保持。若段未被锁定,或锁由另一进程所保持,则什么也不会发生并返回 false。
另请参阅 lock ().