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