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
31
32
33
34
35
36
37
38
39
40
41
42
43
44

use crate::spi::{BinData, FnTable};
use crate::{Bin, IntoUnSyncView, SBin};

/// A binary that's always empty.
pub struct EmptyBin;

impl EmptyBin {
    /// Creates a new empty binary.
    #[inline]
    pub const fn empty_sbin() -> SBin {
        SBin(Bin::_const_new(BinData::empty(), &FN_TABLE))
    }
}

const FN_TABLE: FnTable = FnTable {
    drop: None,
    as_slice: None,
    is_empty: None,
    clone,
    into_vec,
    slice,
    // not required: there's no non-synced version.
    convert_into_un_sync: None,
    // not required: this is already the sync version.
    convert_into_sync: None,
    // not supported.
    try_re_integrate: None,
};

fn clone(_: &Bin) -> Bin {
    EmptyBin::empty_sbin().un_sync()
}

fn into_vec(_: Bin) -> Vec<u8> {
    Vec::new()
}

fn slice(_: &Bin, start: usize, end_excluded: usize) -> Option<Bin> {
    if start == 0 && end_excluded == 0 {
        Some(EmptyBin::empty_sbin().un_sync())
    } else {
        None
    }
}