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);