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]".