#zero-copy #parser

no-std zc

Self-referential zero-copy structure

3 releases (breaking)

0.4.0 Feb 18, 2021
0.3.0 Jan 20, 2021
0.2.0 Dec 23, 2020
0.1.2 Dec 8, 2020

#387 in Memory management

45 downloads per month
Used in dangerous

MIT license

26KB
410 lines

Build Status Coverage Status Crate Docs

rust-zc

Rust library providing Zc for self-referential zero-copy structures.
Documentation hosted on docs.rs.

zc = "0.4"

Usage

use zc::Dependant;

#[derive(PartialEq, Debug, Dependant)]
pub struct StructWithBytes<'a>(&'a [u8]);

impl<'a> From<&'a [u8]> for StructWithBytes<'a> {
    fn from(bytes: &'a [u8]) -> Self {
        Self(&bytes[1..])
    }
}

fn main() {
    let owner = vec![1, 2, 3];
    let data = zc::from!(owner, StructWithBytes, [u8]);

    assert_eq!(
        data.get::<StructWithBytes>(),
        &StructWithBytes(&[2, 3])
    )
}

Testing

Run standard tests:

cargo test

Run miri tests:

cargo miri test --test test_zc

Dependencies

~220KB