Rust Vec.from_raw_parts_in用法及代码示例

本文简要介绍rust语言中 std::vec::Vec.from_raw_parts_in 的用法。

用法

pub unsafe fn from_raw_parts_in(    ptr: *mut T,     length: usize,     capacity: usize,     alloc: A) -> Vec<T, A>

直接从另一个向量的原始分量创建 Vec<T, A>。

安全性

由于未检查的不变量的数量，这是非常不安全的：

ptr 需要先前已通过 String /Vec<T> 分配(至少，如果不是，它很可能是不正确的)。
T 需要与 ptr 分配的大小和对齐方式相同。 (T 具有不太严格的对齐方式是不够的，对齐方式确实需要满足 dealloc 要求，即必须使用相同的布局分配和释放内存。)
length 需要小于或等于 capacity 。
capacity 需要是分配指针的容量。

违反这些可能会导致问题，例如损坏分配器的内部数据结构。例如它是不是安全地建立一个Vec<u8>从指针到 Cchar有长度的数组size_t。从 a 构建一个也不安全Vec<u16>及其长度，因为分配器关心对齐方式，而这两种类型具有不同的对齐方式。缓冲区以对齐方式 2 分配(对于u16)，但是将其变成Vec<u8>它将通过对齐方式 1 被释放。

ptr 的所有权有效地转移到Vec<T>，然后可以随意释放、重新分配或更改指针指向的内存内容。确保调用此函数后没有其他任何东西使用该指针。

例子

#![feature(allocator_api)]

use std::alloc::System;

use std::ptr;
use std::mem;

let mut v = Vec::with_capacity_in(3, System);
v.push(1);
v.push(2);
v.push(3);

// Prevent running `v`'s destructor so we are in complete control
// of the allocation.
let mut v = mem::ManuallyDrop::new(v);

// Pull out the various important pieces of information about `v`
let p = v.as_mut_ptr();
let len = v.len();
let cap = v.capacity();
let alloc = v.allocator();

unsafe {
    // Overwrite memory with 4, 5, 6
    for i in 0..len as isize {
        ptr::write(p.offset(i), 4 + i);
    }

    // Put everything back together into a Vec
    let rebuilt = Vec::from_raw_parts_in(p, len, cap, alloc.clone());
    assert_eq!(rebuilt, [4, 5, 6]);
}

相关用法

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