本文簡要介紹rust語言中 std::sync::atomic::AtomicU64.compare_and_swap
的用法。
用法
pub fn compare_and_swap(&self, current: u64, new: u64, order: Ordering) -> u64
如果當前值與 current
值相同,則將值存儲到原子整數中。
返回值始終是前一個值。如果它等於 current
,則該值已更新。
compare_and_swap
還接受一個 Ordering
參數,該參數說明了此操作的內存順序。請注意,即使使用 AcqRel
,操作也可能會失敗,因此隻執行 Acquire
加載,但沒有 Release
語義。使用 Acquire
使存儲部分成為此操作 Relaxed
(如果發生),使用 Release
使加載部分成為 Relaxed
。
注意:此方法僅適用於支持原子操作的平台u64
.
遷移到 compare_exchange
和 compare_exchange_weak
compare_and_swap
等價於 compare_exchange
,具有以下內存排序映射:
原版的 | 成功 | 失敗 |
---|---|---|
Relaxed | Relaxed | Relaxed |
Acquire | Acquire | Acquire |
Release | Release | Relaxed |
AcqRel | AcqRel | Acquire |
SeqCst | SeqCst | SeqCst |
即使比較成功,compare_exchange_weak
也允許虛假失敗,這允許編譯器在循環中使用比較和交換時生成更好的匯編代碼。
例子
use std::sync::atomic::{AtomicU64, Ordering};
let some_var = AtomicU64::new(5);
assert_eq!(some_var.compare_and_swap(5, 10, Ordering::Relaxed), 5);
assert_eq!(some_var.load(Ordering::Relaxed), 10);
assert_eq!(some_var.compare_and_swap(6, 12, Ordering::Relaxed), 10);
assert_eq!(some_var.load(Ordering::Relaxed), 10);
相關用法
- Rust AtomicU64.compare_exchange用法及代碼示例
- Rust AtomicU64.compare_exchange_weak用法及代碼示例
- Rust AtomicU64.into_inner用法及代碼示例
- Rust AtomicU64.fetch_update用法及代碼示例
- Rust AtomicU64.fetch_or用法及代碼示例
- Rust AtomicU64.new用法及代碼示例
- Rust AtomicU64.as_mut_ptr用法及代碼示例
- Rust AtomicU64.fetch_and用法及代碼示例
- Rust AtomicU64.get_mut用法及代碼示例
- Rust AtomicU64.from_mut用法及代碼示例
- Rust AtomicU64.fetch_sub用法及代碼示例
- Rust AtomicU64.fetch_max用法及代碼示例
- Rust AtomicU64.fetch_min用法及代碼示例
- Rust AtomicU64.fetch_nand用法及代碼示例
- Rust AtomicU64.fetch_xor用法及代碼示例
- Rust AtomicU64.load用法及代碼示例
- Rust AtomicU64.swap用法及代碼示例
- Rust AtomicU64.fetch_add用法及代碼示例
- Rust AtomicU64.store用法及代碼示例
- Rust AtomicU8.fetch_sub用法及代碼示例
- Rust AtomicU32.fetch_min用法及代碼示例
- Rust AtomicU8.fetch_or用法及代碼示例
- Rust AtomicUsize.load用法及代碼示例
- Rust AtomicU16.into_inner用法及代碼示例
- Rust AtomicU16.from_mut用法及代碼示例
注:本文由純淨天空篩選整理自rust-lang.org大神的英文原創作品 std::sync::atomic::AtomicU64.compare_and_swap。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。