Rust AtomicPtr.fetch_update用法及代码示例

用法

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

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

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

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

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

注意：此方法仅在支持指针原子操作的平台上可用。

例子

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

let ptr: *mut _ = &mut 5;
let some_ptr = AtomicPtr::new(ptr);

let new: *mut _ = &mut 10;
assert_eq!(some_ptr.fetch_update(Ordering::SeqCst, Ordering::SeqCst, |_| None), Err(ptr));
let result = some_ptr.fetch_update(Ordering::SeqCst, Ordering::SeqCst, |x| {
    if x == ptr {
        Some(new)
    } else {
        None
    }
});
assert_eq!(result, Ok(ptr));
assert_eq!(some_ptr.load(Ordering::SeqCst), new);