当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Rust pointer.as_ref用法及代码示例


本文简要介绍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);
}

相关用法


注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 pointer.as_ref。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。