Rust pointer.as_ref用法及代碼示例

用法

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

如果指針為 null，則返回 None，否則返回對 Some 中包裝的值的共享引用。如果該值可能未初始化，則必須使用as_uninit_ref 代替。

安全性

調用此方法時，您必須確保指針為空或以下所有條件都為真：

• 指針必須正確對齊。

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

• 指針必須指向 T 的初始化實例。

• 您必須強製執行 Rust 的別名規則，因為返回的生命周期 'a 是任意選擇的，不一定反映數據的實際生命周期。特別是，在此生命周期內，指針指向的內存不得發生突變(UnsafeCell 內部除外)。

即使此方法的結果未使用，這也適用！ (關於被初始化的部分還沒有完全確定，但在確定之前，唯一安全的方法是確保它們確實被初始化。)

例子

基本用法：

let ptr: *const u8 = &10u8 as *const u8;

unsafe {
    if let Some(val_back) = ptr.as_ref() {
        println!("We got back the value: {}!", val_back);
    }
}

Null-unchecked版本

如果您確定指針永遠不會為空並且正在尋找某種返回 &T 而不是 Option<&T> 的 as_ref_unchecked ，請知道您可以直接取消引用指針。

let ptr: *const u8 = &10u8 as *const u8;

unsafe {
    let val_back = &*ptr;
    println!("We got back the value: {}!", val_back);
}