QAtomicPointer 类是为指针提供独立于平台的原子操作的模板类。 更多...
头: | #include <QAtomicPointer> |
CMake: |
find_package(Qt6 COMPONENTS Core REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
QAtomicPointer (const QAtomicPointer<T> & other ) | |
QAtomicPointer (T * value = nullptr) | |
QAtomicPointer<T> & | operator= (const QAtomicPointer<T> & other ) |
T * | fetchAndAddAcquire (qptrdiff valueToAdd ) |
T * | fetchAndAddOrdered (qptrdiff valueToAdd ) |
T * | fetchAndAddRelaxed (qptrdiff valueToAdd ) |
T * | fetchAndAddRelease (qptrdiff valueToAdd ) |
T * | fetchAndStoreAcquire (T * newValue ) |
T * | fetchAndStoreOrdered (T * newValue ) |
T * | fetchAndStoreRelaxed (T * newValue ) |
T * | fetchAndStoreRelease (T * newValue ) |
T * | loadAcquire () const |
T * | loadRelaxed () const |
void | storeRelaxed (T * newValue ) |
void | storeRelease (T * newValue ) |
bool | testAndSetAcquire (T * expectedValue , T * newValue ) |
bool | testAndSetOrdered (T * expectedValue , T * newValue ) |
bool | testAndSetRelaxed (T * expectedValue , T * newValue ) |
bool | testAndSetRelease (T * expectedValue , T * newValue ) |
bool | isFetchAndAddNative () |
bool | isFetchAndAddWaitFree () |
bool | isFetchAndStoreNative () |
bool | isFetchAndStoreWaitFree () |
bool | isTestAndSetNative () |
bool | isTestAndSetWaitFree () |
有关整数的原子操作,见 QAtomicInteger 类。
atomic operation is a complex operation that completes without interruption. The QAtomicPointer class provides atomic test-and-set, fetch-and-store, and fetch-and-add for pointers.
QAtomicPointer provides several implementations of the atomic test-and-set, fetch-and-store, and fetch-and-add functions. Each implementation defines a memory ordering semantic that describes how memory accesses surrounding the atomic instruction are executed by the processor. Since many modern architectures allow out-of-order execution and memory ordering, using the correct semantic is necessary to ensure that your application functions properly on all processors.
If the current value of the QAtomicPointer is an expected value, the test-and-set functions assign a new value to the QAtomicPointer and return true. If values are not the same, these functions do nothing and return false. This operation equates to the following code:
if (currentValue == expectedValue) { currentValue = newValue; return true; } return false;
There are 4 test-and-set functions: testAndSetRelaxed (), testAndSetAcquire (), testAndSetRelease (),和 testAndSetOrdered (). See above for an explanation of the different memory ordering semantics.
The atomic fetch-and-store functions read the current value of the QAtomicPointer and then assign a new value, returning the original value. This operation equates to the following code:
T *originalValue = currentValue; currentValue = newValue; return originalValue;
There are 4 fetch-and-store functions: fetchAndStoreRelaxed (), fetchAndStoreAcquire (), fetchAndStoreRelease (),和 fetchAndStoreOrdered (). See above for an explanation of the different memory ordering semantics.
The atomic fetch-and-add functions read the current value of the QAtomicPointer and then add the given value to the current value, returning the original value. This operation equates to the following code:
T *originalValue = currentValue; currentValue += valueToAdd; return originalValue;
There are 4 fetch-and-add functions: fetchAndAddRelaxed (), fetchAndAddAcquire (), fetchAndAddRelease (),和 fetchAndAddOrdered (). See above for an explanation of the different memory ordering semantics.
Providing a platform-independent atomic API that works on all processors is challenging. The API provided by QAtomicPointer is guaranteed to work atomically on all processors. However, since not all processors implement support for every operation provided by QAtomicPointer, it is necessary to expose information about the processor.
You can check at compile time which features are supported on your hardware using various macros. These will tell you if your hardware always, sometimes, or does not support a particular operation. The macros have the form Q_ATOMIC_POINTER_ OPERATION _IS_ HOW _NATIVE. OPERATION is one of TEST_AND_SET , FETCH_AND_STORE ,或 FETCH_AND_ADD ,和 HOW is one of ALWAYS, SOMETIMES, or NOT. There will always be exactly one defined macro per operation. For example, if Q_ATOMIC_POINTER_TEST_AND_SET_IS_ALWAYS_NATIVE is defined, neither Q_ATOMIC_POINTER_TEST_AND_SET_IS_SOMETIMES_NATIVE nor Q_ATOMIC_POINTER_TEST_AND_SET_IS_NOT_NATIVE will be defined.
An operation that completes in constant time is said to be wait-free. Such operations are not implemented using locks or loops of any kind. For atomic operations that are always supported, and that are wait-free, Qt defines the Q_ATOMIC_POINTER_ OPERATION _IS_WAIT_FREE in addition to the Q_ATOMIC_POINTER_ OPERATION _IS_ALWAYS_NATIVE.
In cases where an atomic operation is only supported in newer generations of the processor, QAtomicPointer also provides a way to check at runtime what your hardware supports with the isTestAndSetNative (), isFetchAndStoreNative (),和 isFetchAndAddNative () functions. Wait-free implementations can be detected using the isTestAndSetWaitFree (), isFetchAndStoreWaitFree (),和 isFetchAndAddWaitFree () 函数。
Below is a complete list of all feature macros for QAtomicPointer:
另请参阅 QAtomicInteger .
构造副本为 other .
构造 QAtomicPointer 采用给定 value .
赋值 other 到此 QAtomicPointer and returns a reference to this QAtomicPointer .
原子抓取和添加。
Reads the current value of this QAtomicPointer and then adds valueToAdd to the current value, returning the original value.
此函数使用 acquire memory ordering semantics, which ensures that memory access following the atomic operation (in program order) may not be re-ordered before the atomic operation.
原子抓取和添加。
Reads the current value of this QAtomicPointer and then adds valueToAdd to the current value, returning the original value.
此函数使用 ordered memory ordering semantics, which ensures that memory access before and after the atomic operation (in program order) may not be re-ordered.
原子抓取和添加。
Reads the current value of this QAtomicPointer and then adds valueToAdd to the current value, returning the original value.
此函数使用 relaxed memory ordering semantics, leaving the compiler and processor to freely reorder memory accesses.
原子抓取和添加。
Reads the current value of this QAtomicPointer and then adds valueToAdd to the current value, returning the original value.
此函数使用 release memory ordering semantics, which ensures that memory access before the atomic operation (in program order) may not be re-ordered after the atomic operation.
原子抓取和存储。
Reads the current value of this QAtomicPointer and then assigns it the newValue , returning the original value.
此函数使用 acquire memory ordering semantics, which ensures that memory access following the atomic operation (in program order) may not be re-ordered before the atomic operation.
原子抓取和存储。
Reads the current value of this QAtomicPointer and then assigns it the newValue , returning the original value.
此函数使用 ordered memory ordering semantics, which ensures that memory access before and after the atomic operation (in program order) may not be re-ordered.
原子抓取和存储。
Reads the current value of this QAtomicPointer and then assigns it the newValue , returning the original value.
此函数使用 relaxed memory ordering semantics, leaving the compiler and processor to freely reorder memory accesses.
原子抓取和存储。
Reads the current value of this QAtomicPointer and then assigns it the newValue , returning the original value.
此函数使用 release memory ordering semantics, which ensures that memory access before the atomic operation (in program order) may not be re-ordered after the atomic operation.
[static]
bool
QAtomicPointer::
isFetchAndAddNative
()
返回
true
if fetch-and-add is implemented using atomic processor instructions, false otherwise.
[static]
bool
QAtomicPointer::
isFetchAndAddWaitFree
()
返回
true
if atomic fetch-and-add is wait-free, false otherwise.
[static]
bool
QAtomicPointer::
isFetchAndStoreNative
()
返回
true
if fetch-and-store is implemented using atomic processor instructions, false otherwise.
[static]
bool
QAtomicPointer::
isFetchAndStoreWaitFree
()
返回
true
if atomic fetch-and-store is wait-free, false otherwise.
[static]
bool
QAtomicPointer::
isTestAndSetNative
()
返回
true
if test-and-set is implemented using atomic processor instructions, false otherwise.
[static]
bool
QAtomicPointer::
isTestAndSetWaitFree
()
返回
true
if atomic test-and-set is wait-free, false otherwise.
Atomically loads the value of this QAtomicPointer using the "Acquire" memory ordering. The value is not modified in any way, but note that there's no guarantee that it remains so.
另请参阅 storeRelease () 和 loadRelaxed ().
[since 5.14]
T
*QAtomicPointer::
loadRelaxed
() const
Atomically loads the value of this QAtomicPointer using relaxed memory ordering. The value is not modified in any way, but note that there's no guarantee that it remains so.
该函数在 Qt 5.14 引入。
另请参阅 storeRelaxed () 和 loadAcquire ().
[since 5.14]
void
QAtomicPointer::
storeRelaxed
(
T
*
newValue
)
Atomically stores the newValue value into this atomic type, using relaxed memory ordering.
该函数在 Qt 5.14 引入。
另请参阅 storeRelease () 和 loadRelaxed ().
Atomically stores the newValue value into this atomic type, using the "Release" memory ordering.
另请参阅 storeRelaxed () 和 loadRelaxed ().
Atomic test-and-set.
If the current value of this
QAtomicPointer
是
expectedValue
, the test-and-set functions assign the
newValue
到此
QAtomicPointer
and return true. If the values are
not
the same, this function does nothing and returns
false
.
此函数使用 acquire memory ordering semantics, which ensures that memory access following the atomic operation (in program order) may not be re-ordered before the atomic operation.
Atomic test-and-set.
If the current value of this
QAtomicPointer
是
expectedValue
, the test-and-set functions assign the
newValue
到此
QAtomicPointer
and return true. If the values are
not
the same, this function does nothing and returns
false
.
此函数使用 ordered memory ordering semantics, which ensures that memory access before and after the atomic operation (in program order) may not be re-ordered.
Atomic test-and-set.
If the current value of this
QAtomicPointer
是
expectedValue
, the test-and-set functions assign the
newValue
到此
QAtomicPointer
and return true. If the values are
not
the same, this function does nothing and returns
false
.
此函数使用 relaxed memory ordering semantics, leaving the compiler and processor to freely reorder memory accesses.
Atomic test-and-set.
If the current value of this
QAtomicPointer
是
expectedValue
, the test-and-set functions assign the
newValue
到此
QAtomicPointer
and return true. If the values are
not
the same, this function does nothing and returns
false
.
此函数使用 release memory ordering semantics, which ensures that memory access before the atomic operation (in program order) may not be re-ordered after the atomic operation.
This macro is defined if and only if your processor supports atomic fetch-and-add on pointers.
This macro is defined when the hardware does not support atomic fetch-and-add on pointers.
This macro is defined when only certain generations of the processor support atomic fetch-and-add on pointers. Use the QAtomicPointer::isFetchAndAddNative () function to check what your processor supports.
This macro is defined together with Q_ATOMIC_POINTER_FETCH_AND_ADD_IS_ALWAYS_NATIVE to indicate that the atomic fetch-and-add on pointers is wait-free.
This macro is defined if and only if your processor supports atomic fetch-and-store on pointers.
This macro is defined when the hardware does not support atomic fetch-and-store on pointers.
This macro is defined when only certain generations of the processor support atomic fetch-and-store on pointers. Use the QAtomicPointer::isFetchAndStoreNative () function to check what your processor supports.
This macro is defined together with Q_ATOMIC_POINTER_FETCH_AND_STORE_IS_ALWAYS_NATIVE to indicate that the atomic fetch-and-store on pointers is wait-free.
This macro is defined if and only if your processor supports atomic test-and-set on pointers.
This macro is defined when the hardware does not support atomic test-and-set on pointers.
This macro is defined when only certain generations of the processor support atomic test-and-set on pointers. Use the QAtomicPointer::isTestAndSetNative () function to check what your processor supports.
This macro is defined together with Q_ATOMIC_POINTER_TEST_AND_SET_IS_ALWAYS_NATIVE to indicate that the atomic test-and-set on pointers is wait-free.