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

use serde::export::PhantomData;

use crate::{AnyBin, Bin, Binaries, IntoUnSyncView, SBin, ScopedRiSetup};

/// Constructs `ScopedRiSetup` with sane defaults.
pub struct DefaultScopes {
    _phantom: PhantomData<()>,
}

impl DefaultScopes {
    /// A scope that can be used to de-serialize `Bin` and `SBin`. If a `Bin` is required,
    /// the `SBin` value is converted using `IntoUnSyncView` (so just a view).
    ///
    /// This is what you most likely want to use if you can't guarantee that you don't
    /// de-serialize only `Bin`.
    pub fn sync(bin: &SBin) -> ScopedRiSetup {
        ScopedRiSetup::new(
            Binaries::new_sync_bin(bin),
            sync_re_integration_fn,
            sync_sync_re_integration_fn,
        )
    }
}

fn sync_re_integration_fn(binaries: &Binaries, slice: &[u8]) -> Option<Bin> {
    match binaries.both() {
        (Some(bin), _) => bin.try_to_re_integrate(slice),
        (_, Some(sync)) => sync.try_to_re_integrate(slice).map(|item| item.un_sync()),
        _ => None,
    }
}

fn sync_sync_re_integration_fn(binaries: &Binaries, slice: &[u8]) -> Option<SBin> {
    if let Some(bin) = binaries.sync_bin() {
        bin.try_to_re_integrate(slice)
    } else {
        None
    }
}