Rust pointer.as_mut用法及代码示例

用法

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

如果指针为 null，则返回 None，否则返回对 Some 中包装的值的唯一引用。如果该值可能未初始化，则必须使用as_uninit_mut 代替。

对于共享对应部分，请参阅as_ref。

安全性

调用此方法时，您必须确保指针为空或以下所有条件都为真：

• 指针必须正确对齐。

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

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

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

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

例子

基本用法：

let mut s = [1, 2, 3];
let ptr: *mut u32 = s.as_mut_ptr();
let first_value = unsafe { ptr.as_mut().unwrap() };
*first_value = 4;
println!("{:?}", s); // It'll print: "[4, 2, 3]".

Null-unchecked版本

如果您确定指针永远不会为空并且正在寻找某种返回 &mut T 而不是 Option<&mut T> 的 as_mut_unchecked ，请知道您可以直接取消引用指针。

let mut s = [1, 2, 3];
let ptr: *mut u32 = s.as_mut_ptr();
let first_value = unsafe { &mut *ptr };
*first_value = 4;
println!("{:?}", s); // It'll print: "[4, 2, 3]".