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

use abin::{AnyBin, BinFactory, NewBin};

const EMPTY: &[u8] = &[];
const ONE: &[u8] = &[15];
const MANY: &[u8] = &[12, 44, 15, 8, 255, 0, 254];
const LARGE: &str = "Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy \
eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero \
eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata \
sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, \
sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam \
voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, \
no sea takimata sanctus est Lorem ipsum dolor sit amet.";

#[test]
fn basic_static() {
    test_static(EMPTY);
    test_static(ONE);
    test_static(MANY);
    test_static(LARGE.as_bytes());
}

fn test_static(slice: &'static [u8]) {
    let slice_ptr = slice.as_ptr();
    let bin = NewBin::from_static(slice);
    assert_eq!(slice.len(), bin.len());
    assert_eq!(slice, bin.as_slice());

    // non-empty slices must point to the same memory location
    if !slice.is_empty() {
        let bin_slice_ptr = bin.as_slice().as_ptr();
        assert_eq!(slice_ptr, bin_slice_ptr);
    }
}