Rust NonNull.as_ref用法及代码示例

用法

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

返回对该值的共享引用。如果该值可能未初始化，则必须改用 as_uninit_ref 。

对于可变对应物，请参见 as_mut 。

安全性

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

• 指针必须正确对齐。

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

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

• 您必须强制执行 Rust 的别名规则，因为返回的生命周期 'a 是任意选择的，不一定反映数据的实际生命周期。特别是，在此生命周期内，指针指向的内存不得发生突变(UnsafeCell 内部除外)。

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

例子

use std::ptr::NonNull;

let mut x = 0u32;
let ptr = NonNull::new(&mut x as *mut _).expect("ptr is null!");

let ref_x = unsafe { ptr.as_ref() };
println!("{}", ref_x);