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