当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Rust AtomicU16.fetch_update用法及代码示例


本文简要介绍rust语言中 core::sync::atomic::AtomicU16.fetch_update 的用法。

用法

pub fn fetch_update<F>(    &self,     set_order: Ordering,     fetch_order: Ordering,     f: F) -> Result<u16, u16> where    F: FnMut(u16) -> Option<u16>,

获取该值,并对其应用一个返回可选新值的函数。如果函数返回 Some(_) ,则返回 Ok(previous_value)Result ,否则返回 Err(previous_value)

注意:如果同时其他线程更改了该值,则可能会多次调用该函数,只要该函数返回 Some(_) ,但该函数只会对存储的值应用一次。

fetch_update 采用两个 Ordering 参数来说明此操作的内存顺序。第一个说明了操作最终成功时所需的顺序,而第二个说明了加载所需的顺序。这些分别对应 AtomicU16::compare_exchange 的成功和失败顺序。

使用 Acquire 作为成功排序使存储成为此操作的一部分 Relaxed ,使用 Release 使最终成功加载 Relaxed 。 (失败的)加载排序只能是 SeqCst Acquire Relaxed ,并且必须等于或弱于成功排序。

注意:此方法仅适用于支持原子操作的平台u16.

例子

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

let x = AtomicU16::new(7);
assert_eq!(x.fetch_update(Ordering::SeqCst, Ordering::SeqCst, |_| None), Err(7));
assert_eq!(x.fetch_update(Ordering::SeqCst, Ordering::SeqCst, |x| Some(x + 1)), Ok(7));
assert_eq!(x.fetch_update(Ordering::SeqCst, Ordering::SeqCst, |x| Some(x + 1)), Ok(8));
assert_eq!(x.load(Ordering::SeqCst), 9);

相关用法


注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 core::sync::atomic::AtomicU16.fetch_update。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。