Rust NonNull.as_mut用法及代码示例

用法

pub unsafe fn as_mut<'a>(&mut self) -> &'a mut T

返回对该值的唯一引用。如果该值可能未初始化，则必须改用 as_uninit_mut 。

对于共享副本，请参阅 as_ref 。

安全性

调用此方法时，您必须确保满足以下所有条件：

• 指针必须正确对齐。

• 它必须是the module documentation 中定义的意义上的“dereferencable”。

• 指针必须指向 T 的初始化实例。

• 您必须强制执行 Rust 的别名规则，因为返回的生命周期 'a 是任意选择的，不一定反映数据的实际生命周期。特别是，在此生命周期内，指针指向的内存不得通过任何其他指针访问(读取或写入)。

即使此方法的结果未使用，这也适用！ (关于被初始化的部分还没有完全确定，但在确定之前，唯一安全的方法是确保它们确实被初始化。)

例子

use std::ptr::NonNull;

let mut x = 0u32;
let mut ptr = NonNull::new(&mut x).expect("null pointer");

let x_ref = unsafe { ptr.as_mut() };
assert_eq!(*x_ref, 0);
*x_ref += 2;
assert_eq!(*x_ref, 2);