本文簡要介紹rust語言中 std::sync::atomic::AtomicI16.compare_and_swap
的用法。
用法
pub fn compare_and_swap(&self, current: i16, new: i16, order: Ordering) -> i16
如果當前值與 current
值相同,則將值存儲到原子整數中。
返回值始終是前一個值。如果它等於 current
,則該值已更新。
compare_and_swap
還接受一個 Ordering
參數,該參數說明了此操作的內存順序。請注意,即使使用 AcqRel
,操作也可能會失敗,因此隻執行 Acquire
加載,但沒有 Release
語義。使用 Acquire
使存儲部分成為此操作 Relaxed
(如果發生),使用 Release
使加載部分成為 Relaxed
。
注意:此方法僅適用於支持原子操作的平台i16
.
遷移到 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::{AtomicI16, Ordering};
let some_var = AtomicI16::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 AtomicI16.compare_exchange_weak用法及代碼示例
- Rust AtomicI16.compare_exchange用法及代碼示例
- Rust AtomicI16.fetch_min用法及代碼示例
- Rust AtomicI16.fetch_and用法及代碼示例
- Rust AtomicI16.fetch_nand用法及代碼示例
- Rust AtomicI16.swap用法及代碼示例
- Rust AtomicI16.into_inner用法及代碼示例
- Rust AtomicI16.fetch_sub用法及代碼示例
- Rust AtomicI16.fetch_add用法及代碼示例
- Rust AtomicI16.fetch_xor用法及代碼示例
- Rust AtomicI16.new用法及代碼示例
- Rust AtomicI16.as_mut_ptr用法及代碼示例
- Rust AtomicI16.load用法及代碼示例
- Rust AtomicI16.get_mut用法及代碼示例
- Rust AtomicI16.from_mut用法及代碼示例
- Rust AtomicI16.fetch_max用法及代碼示例
- Rust AtomicI16.fetch_update用法及代碼示例
- Rust AtomicI16.store用法及代碼示例
- Rust AtomicI16.fetch_or用法及代碼示例
- Rust AtomicI8.fetch_or用法及代碼示例
- Rust AtomicI8.as_mut_ptr用法及代碼示例
- Rust AtomicI32.compare_exchange用法及代碼示例
- Rust AtomicI64.from_mut用法及代碼示例
- Rust AtomicI32.fetch_and用法及代碼示例
- Rust AtomicI64.compare_exchange_weak用法及代碼示例
注:本文由純淨天空篩選整理自rust-lang.org大神的英文原創作品 std::sync::atomic::AtomicI16.compare_and_swap。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。