Rust Box.from_raw用法及代码示例

本文简要介绍rust语言中 std::boxed::Box.from_raw 的用法。

用法

pub unsafe fn from_raw(raw: *mut T) -> Box<T, Global>

从原始指针构造一个框。

调用此函数后，原始指针归生成的 Box 所有。具体来说，Box 析构函数将调用T 的析构函数并释放分配的内存。为了安全起见，必须根据 Box 使用的 memory layout 分配内存。

安全性

此函数不安全，因为使用不当可能会导致内存问题。例如，如果函数在同一个原始指针上调用两次，则可能会出现 double-free。

安全条件在 memory layout 部分中说明。

例子

重新创建以前使用 Box::into_raw 转换为原始指针的 Box ：

let x = Box::new(5);
let ptr = Box::into_raw(x);
let x = unsafe { Box::from_raw(ptr) };

使用全局分配器从头开始手动创建Box：

use std::alloc::{alloc, Layout};

unsafe {
    let ptr = alloc(Layout::new::<i32>()) as *mut i32;
    // In general .write is required to avoid attempting to destruct
    // the (uninitialized) previous contents of `ptr`, though for this
    // simple example `*ptr = 5` would have worked as well.
    ptr.write(5);
    let x = Box::from_raw(ptr);
}

相关用法

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