QAtomicPointer Class

if (currentValue == expectedValue) {
    currentValue = newValue;
    return true;
}
return false;

T *originalValue = currentValue;
currentValue = newValue;
return originalValue;

T *originalValue = currentValue;
currentValue += valueToAdd;
return originalValue;

成员函数文档

[constexpr noexcept] QAtomicPointer::QAtomicPointer(T *value = nullptr)

根据给定的value ，构建一个QAtomicPointer。

[noexcept] QAtomicPointer::QAtomicPointer(const QAtomicPointer<T> &other)

创建other 的副本。

T *QAtomicPointer::fetchAndAddAcquire(qptrdiff valueToAdd)

原子读取并加法。

读取该QAtomicPointer 的当前值，然后将valueToAdd 加到当前值上，并返回原始值。

该函数采用“获取 memory ordering ”语义，这确保了在原子操作之后（按程序顺序）进行的内存访问，不会被重新排序到原子操作之前。

T *QAtomicPointer::fetchAndAddOrdered(qptrdiff valueToAdd)

原子读取并加法。

读取该QAtomicPointer 的当前值，然后将valueToAdd 加到当前值上，并返回原始值。

该函数采用有序 memory ordering 语义，这确保了原子操作前后（按程序顺序）的内存访问不会被重新排序。

T *QAtomicPointer::fetchAndAddRelaxed(qptrdiff valueToAdd)

原子读取并加法操作。

读取该QAtomicPointer 的当前值，然后将valueToAdd 加到当前值上，并返回原始值。

该函数采用宽松的 memory ordering 语义，允许编译器和处理器自由重排内存访问顺序。

T *QAtomicPointer::fetchAndAddRelease(qptrdiff valueToAdd)

原子读取并加法操作。

读取该QAtomicPointer 的当前值，然后将valueToAdd 加到当前值上，并返回原始值。

该函数采用“释放” memory ordering 语义，这确保了（按程序顺序）在原子操作之前进行的内存访问，在原子操作之后不会被重新排序。

T *QAtomicPointer::fetchAndStoreAcquire(T *newValue)

原子读取-存储操作。

读取该QAtomicPointer 的当前值，然后将其赋值为newValue ，并返回原始值。

该函数采用“获取-memory ordering ”语义，这确保了在原子操作之后（按程序顺序）的内存访问，不会被重新排序至原子操作之前。

T *QAtomicPointer::fetchAndStoreOrdered(T *newValue)

原子读取-存储操作。

读取该QAtomicPointer 的当前值，然后将其赋值为newValue ，并返回原始值。

该函数采用有序 memory ordering 语义，这确保了原子操作前后（按程序顺序）的内存访问不会被重新排序。

T *QAtomicPointer::fetchAndStoreRelaxed(T *newValue)

原子读取和写入。

读取该QAtomicPointer 的当前值，然后将其赋值给newValue ，并返回原始值。

该函数采用宽松的 memory ordering 语义，允许编译器和处理器自由重排内存访问的顺序。

T *QAtomicPointer::fetchAndStoreRelease(T *newValue)

原子读取-写入操作。

读取该QAtomicPointer 的当前值，然后将其赋值为newValue ，并返回原始值。

该函数采用“释放” memory ordering 语义，这确保了（按程序顺序）在原子操作之前进行的内存访问，在原子操作之后不会被重新排序。

[static constexpr] bool QAtomicPointer::isFetchAndAddNative()

如果 `fetch-and-add` 是通过原子处理器指令实现的，则返回 `true `；否则返回 `false`。

[static constexpr] bool QAtomicPointer::isFetchAndAddWaitFree()

如果原子“读取并加”操作是无等待的，则返回true ；否则返回false。

[static constexpr] bool QAtomicPointer::isFetchAndStoreNative()

如果“fetch-and-store”操作是通过原子处理器指令实现的，则返回true ；否则返回false。

[static constexpr] bool QAtomicPointer::isFetchAndStoreWaitFree()

如果原子读写操作是无等待的，则返回true ；否则返回false。

[static constexpr] bool QAtomicPointer::isTestAndSetNative()

如果“测试并设置”操作是通过原子处理器指令实现的，则返回true ；否则返回false。

[static constexpr] bool QAtomicPointer::isTestAndSetWaitFree()

如果原子测试并设置操作是无等待的，则返回true ；否则返回false。

T *QAtomicPointer::loadAcquire() const

使用“Acquire”内存排序原子地加载此QAtomicPointer 的值。该值不会以任何方式被修改，但请注意，无法保证其值保持不变。

另请参阅 storeRelease() 和loadRelaxed()。

T *QAtomicPointer::loadRelaxed() const

使用松弛内存排序原子地加载此QAtomicPointer 的值。该值不会以任何方式被修改，但请注意，无法保证其值保持不变。

另请参阅 storeRelaxed() 和loadAcquire()。

void QAtomicPointer::storeRelaxed(T *newValue)

将newValue 的值以原子操作的方式存储到此原子类型中，并采用宽松的内存排序规则。

另请参阅 storeRelease() 和loadRelaxed()。

void QAtomicPointer::storeRelease(T *newValue)

将newValue 的值以原子方式存储到此原子类型中，并采用“Release”内存排序。

另请参阅 storeRelaxed() 和loadRelaxed()。

bool QAtomicPointer::testAndSetAcquire(T *expectedValue, T *newValue)

原子测试并设置。

如果该QAtomicPointer 的当前值是expectedValue ，则“测试并设置”函数会将newValue 赋值给该QAtomicPointer ，并返回true。如果这两个值不相同，则该函数不执行任何操作，并返回false 。

该函数采用“获取” memory ordering 语义，这确保了在原子操作之后（按程序顺序）的内存访问，不会在原子操作之前被重新排序。

bool QAtomicPointer::testAndSetAcquire(T *expectedValue, T *newValue, T *&currentValue)

原子测试并设置。

如果该QAtomicPointer 的当前值是expectedValue ，则“测试并设置”函数会将newValue 赋值给该QAtomicPointer ，并返回true 。如果两个值不相同，则这些函数会将该QAtomicPointer 的当前值加载到currentValue 中，并返回false 。

该函数采用“获取” memory ordering 语义，这确保了在原子操作之后（按程序顺序）的内存访问不会被重新排序至原子操作之前。如果“测试并设置”操作失败，则会采用“获取” memory ordering 语义将currentValue 加载。

bool QAtomicPointer::testAndSetOrdered(T *expectedValue, T *newValue)

原子测试并设置。

如果该QAtomicPointer 的当前值是expectedValue ，则“测试并设置”函数会将newValue 赋值给该QAtomicPointer 并返回true。如果两个值不相同，则该函数不执行任何操作并返回false 。

该函数采用有序的 memory ordering 语义，这确保了（按程序顺序）原子操作前后对内存的访问不会被重新排序。

bool QAtomicPointer::testAndSetOrdered(T *expectedValue, T *newValue, T *&currentValue)

原子测试并设置。

如果该QAtomicPointer 的当前值是expectedValue ，则“测试并设置”函数会将newValue 赋值给该QAtomicPointer ，并返回true 。如果两个值不相同，则这些函数会将该QAtomicPointer 的当前值加载到currentValue 中，并返回false 。

该函数采用有序的 memory ordering 语义，这确保了原子操作前后（按程序顺序）的内存访问不得被重新排序。如果“测试并设置”操作失败，则currentValue 将采用acquire memory ordering 语义进行加载。

bool QAtomicPointer::testAndSetRelaxed(T *expectedValue, T *newValue)

原子测试并设置。

如果该QAtomicPointer 的当前值是expectedValue ，则“测试并设置”函数将newValue 赋值给该QAtomicPointer ，并返回true。如果两个值不相同，则该函数不执行任何操作，并返回false 。

该函数采用宽松的 memory ordering 语义，允许编译器和处理器自由重新排序内存访问操作。

bool QAtomicPointer::testAndSetRelaxed(T *expectedValue, T *newValue, T *&currentValue)

原子测试并设置。

如果该QAtomicPointer 的当前值是expectedValue ，则“测试并设置”函数会将newValue 赋值给该QAtomicPointer ，并返回true 。如果两者值不同，则这些函数会将该QAtomicPointer 的当前值加载到currentValue 中，并返回false 。

该函数采用宽松的 memory ordering 语义，允许编译器和处理器自由重新排序内存访问。如果“测试并设置”操作失败，则currentValue 将采用宽松的 memory ordering 语义进行加载。

bool QAtomicPointer::testAndSetRelease(T *expectedValue, T *newValue)

原子测试与设置。

如果该QAtomicPointer 的当前值是expectedValue ，则“测试并设置”函数会将newValue 赋值给该QAtomicPointer ，并返回true。如果两个值不相同，则该函数不执行任何操作，并返回false 。

该函数采用memory ordering 语义，这确保了（按程序顺序）在原子操作之前进行的内存访问，在原子操作之后不会被重新排序。

bool QAtomicPointer::testAndSetRelease(T *expectedValue, T *newValue, T *&currentValue)

原子测试并设置。

如果该QAtomicPointer 的当前值是expectedValue ，则“测试并设置”函数将newValue 赋值给该QAtomicPointer ，并返回true 。如果两个值不相同，则这些函数将该QAtomicPointer 的当前值读入currentValue ，并返回false 。

该函数采用“释放” memory ordering 语义，这确保了（按程序顺序）在原子操作之前进行的内存访问，在原子操作之后不会被重新排序。如果“测试并设置”操作失败，则currentValue 将采用“松弛” memory ordering 语义进行加载。

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

将 `other ` 赋值给此 `QAtomicPointer `，并返回对此 `QAtomicPointer` 的引用。