Rust AtomicI32.compare_exchange用法及代碼示例

本文簡要介紹rust語言中 core::sync::atomic::AtomicI32.compare_exchange 的用法。

用法

pub fn compare_exchange(    &self,     current: i32,     new: i32,     success: Ordering,     failure: Ordering) -> Result<i32, i32>

如果當前值與 current 值相同，則將值存儲到原子整數中。

返回值是指示是否寫入新值並包含先前值的結果。成功時，此值保證等於 current 。

compare_exchange 采用兩個 Ordering 參數來說明此操作的內存順序。 success 說明了與 current 比較成功時發生的讀取-修改-寫入操作所需的順序。 failure 說明了比較失敗時發生的加載操作所需的順序。使用 Acquire 作為成功排序使存儲成為此操作的一部分 Relaxed ，並使用 Release 使成功加載 Relaxed 。失敗排序隻能是 SeqCst 、 Acquire 或 Relaxed 並且必須等於或弱於成功排序。

注意：此方法僅適用於支持原子操作的平台i32.

例子

use std::sync::atomic::{AtomicI32, Ordering};

let some_var = AtomicI32::new(5);

assert_eq!(some_var.compare_exchange(5, 10,
                                     Ordering::Acquire,
                                     Ordering::Relaxed),
           Ok(5));
assert_eq!(some_var.load(Ordering::Relaxed), 10);

assert_eq!(some_var.compare_exchange(6, 12,
                                     Ordering::SeqCst,
                                     Ordering::Acquire),
           Err(10));
assert_eq!(some_var.load(Ordering::Relaxed), 10);

相關用法

注：本文由純淨天空篩選整理自rust-lang.org大神的英文原創作品 core::sync::atomic::AtomicI32.compare_exchange。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。