本文簡要介紹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]".
相關用法
- Rust pointer.as_mut_ptr用法及代碼示例
- Rust pointer.as_uninit_ref用法及代碼示例
- Rust pointer.as_ptr用法及代碼示例
- Rust pointer.as_ref用法及代碼示例
- Rust pointer.add用法及代碼示例
- Rust pointer.align_offset用法及代碼示例
- Rust pointer.offset_from用法及代碼示例
- Rust pointer.is_null用法及代碼示例
- Rust pointer.get_unchecked用法及代碼示例
- Rust pointer.wrapping_add用法及代碼示例
- Rust pointer.wrapping_offset用法及代碼示例
- Rust pointer.wrapping_sub用法及代碼示例
- Rust pointer.len用法及代碼示例
- Rust pointer.get_unchecked_mut用法及代碼示例
- Rust pointer.sub用法及代碼示例
- Rust pointer.set_ptr_value用法及代碼示例
- Rust pointer.offset用法及代碼示例
- Rust pointer用法及代碼示例
- Rust poll_fn用法及代碼示例
- Rust park用法及代碼示例
- Rust panicking用法及代碼示例
- Rust panic用法及代碼示例
- Rust println用法及代碼示例
- Rust pending用法及代碼示例
- Rust print用法及代碼示例
注:本文由純淨天空篩選整理自rust-lang.org大神的英文原創作品 pointer.as_mut。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。