Rust String.from_raw_parts用法及代码示例

用法

pub unsafe fn from_raw_parts(    buf: *mut u8,     length: usize,     capacity: usize) -> String

根据长度、容量和指针创建一个新的 String。

安全性

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

• buf 处的内存需要由标准库使用的同一个分配器先前分配，并且所需的对齐正好为 1。
• length 需要小于或等于 capacity 。
• capacity 必须是正确的值。
• buf 的第一个 length 字节需要是有效的 UTF-8。

违反这些可能会导致诸如破坏分配器的内部数据结构之类的问题。

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

例子

基本用法：

use std::mem;

unsafe {
    let s = String::from("hello");

    // Prevent automatically dropping the String's data
    let mut s = mem::ManuallyDrop::new(s);

    let ptr = s.as_mut_ptr();
    let len = s.len();
    let capacity = s.capacity();

    let s = String::from_raw_parts(ptr, len, capacity);

    assert_eq!(String::from("hello"), s);
}