abin 0.1.6

A library for working with binaries and strings. The library tries to avoid heap-allocations / memory-copy whenever possible by automatically choosing a reasonable strategy: stack for small binaries; static-lifetime-binary or reference-counting.
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

use core::ptr;

use crate::RcCounter;

/// The metadata stored inside the vector (in-line).
#[repr(C)]
pub struct RcMeta<TCounter: RcCounter> {
    /// The pointer to the vector.
    pub vec_ptr: *const u8,
    /// the capacity of the vector.
    pub capacity: usize,
    /// the reference counter.
    pub counter: TCounter,
}

impl<TCounter: RcCounter> RcMeta<TCounter> {
    pub fn initial(counter: TCounter) -> Self {
        Self {
            vec_ptr: ptr::null(),
            capacity: 0,
            counter,
        }
    }

    /// extracts the embedded vector.
    #[inline]
    pub unsafe fn extract_vec(&self, len: usize) -> Vec<u8> {
        Vec::from_raw_parts(self.vec_ptr as *mut u8, len, self.capacity)
    }
}