本文简要介绍rust语言中 core::sync::atomic::AtomicBool.fetch_update
的用法。
用法
pub fn fetch_update<F>( &self, set_order: Ordering, fetch_order: Ordering, f: F) -> Result<bool, bool> where F: FnMut(bool) -> Option<bool>,
获取该值,并对其应用一个返回可选新值的函数。如果函数返回 Some(_)
,则返回 Ok(previous_value)
的 Result
,否则返回 Err(previous_value)
。
注意:如果同时其他线程更改了该值,则可能会多次调用该函数,只要该函数返回 Some(_)
,但该函数只会对存储的值应用一次。
fetch_update
采用两个 Ordering
参数来说明此操作的内存顺序。第一个说明了操作最终成功时所需的顺序,而第二个说明了加载所需的顺序。这些分别对应 AtomicBool::compare_exchange
的成功和失败顺序。
使用 Acquire
作为成功排序使存储成为此操作的一部分 Relaxed
,使用 Release
使最终成功加载 Relaxed
。 (失败的)加载排序只能是 SeqCst
、 Acquire
或 Relaxed
,并且必须等于或弱于成功排序。
注意:此方法仅在支持原子操作的平台上可用u8
.
例子
use std::sync::atomic::{AtomicBool, Ordering};
let x = AtomicBool::new(false);
assert_eq!(x.fetch_update(Ordering::SeqCst, Ordering::SeqCst, |_| None), Err(false));
assert_eq!(x.fetch_update(Ordering::SeqCst, Ordering::SeqCst, |x| Some(!x)), Ok(false));
assert_eq!(x.fetch_update(Ordering::SeqCst, Ordering::SeqCst, |x| Some(!x)), Ok(true));
assert_eq!(x.load(Ordering::SeqCst), false);
相关用法
- Rust AtomicBool.fetch_nand用法及代码示例
- Rust AtomicBool.fetch_xor用法及代码示例
- Rust AtomicBool.fetch_and用法及代码示例
- Rust AtomicBool.fetch_or用法及代码示例
- Rust AtomicBool.from_mut用法及代码示例
- Rust AtomicBool.compare_and_swap用法及代码示例
- Rust AtomicBool.store用法及代码示例
- Rust AtomicBool.load用法及代码示例
- Rust AtomicBool.compare_exchange用法及代码示例
- Rust AtomicBool.compare_exchange_weak用法及代码示例
- Rust AtomicBool.swap用法及代码示例
- Rust AtomicBool.as_mut_ptr用法及代码示例
- Rust AtomicBool.get_mut用法及代码示例
- Rust AtomicBool.new用法及代码示例
- Rust AtomicBool.into_inner用法及代码示例
- Rust AtomicU8.fetch_sub用法及代码示例
- Rust AtomicPtr.compare_exchange_weak用法及代码示例
- 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-lang.org大神的英文原创作品 core::sync::atomic::AtomicBool.fetch_update。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。