copyless 0.1.3

Ways to eliminate memcpy calls when using the standard library.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

use std::{alloc, mem, ptr};

/// A typesafe helper that stores the allocated pointer without the data initialized.
pub struct BoxAllocation<T>(*mut T);

impl<T> BoxAllocation<T> {
    /// Consumes self and writes the given value into the allocation.
    pub fn init(mut self, value: T) -> Box<T> {
        if mem::size_of::<T>() == 0 {
            return Box::new(value);
        }

        let ptr = mem::replace(&mut self.0, ptr::null_mut());
        unsafe {
            ptr::write(ptr, value);
            Box::from_raw(ptr)
        }
    }
}

impl<T> Drop for BoxAllocation<T> {
    fn drop(&mut self) {
        if !self.0.is_null() {
            let layout = alloc::Layout::new::<T>();
            unsafe {
                alloc::dealloc(self.0 as *mut u8, layout);
            }
        }
    }
}


/// Helper trait for a `Box` type that allocates up-front.
pub trait BoxHelper<T> {
    /// Allocates the storage without providing any data.
    fn alloc() -> BoxAllocation<T>;
}

impl<T> BoxHelper<T> for Box<T> {
    fn alloc() -> BoxAllocation<T> {
        if mem::size_of::<T>() == 0 {
            return BoxAllocation(ptr::null_mut());
        }

        let layout = alloc::Layout::new::<T>();
        BoxAllocation(unsafe {
            alloc::alloc(layout) as *mut T
        })
    }
}