tbytes 0.1.0-alpha2

A tiny library for reading and writing typed data into buffers
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

use tbytes::errors::TBytesError;
use tbytes::{TBytesReader, TBytesReaderFor, TBytesWriter, TBytesWriterFor};

// The contents of this test must be copied to `README.md` and `src/lib/mod.rs` examples.
#[test]
fn example_read_write() -> Result<(), TBytesError> {
    type Content = (i16, f32, [u8; 2], [i16; 2]);
    let mut buffer = [0u8; 12];

    let mut writer = TBytesWriter::from(buffer.as_mut_slice());

    let into_values: Content = (-1048, 0.32, [10, 31], [-1, 240]);
    writer.write(into_values.0)?;
    writer.write(into_values.1)?;
    writer.write_slice(into_values.2.as_slice())?;
    writer.write_array(into_values.3)?;

    assert!(matches!(writer.write(0u8), Err(TBytesError::OutOfBounds)));

    let reader = TBytesReader::from(buffer.as_slice());

    let mut from_values: Content = Content::default();
    from_values.0 = reader.read()?;
    from_values.1 = reader.read()?;
    from_values.2 = reader.read_array()?;
    from_values.3 = reader.read_array()?;

    assert!(matches!(
        reader.read() as Result<u8, TBytesError>,
        Err(TBytesError::OutOfBounds)
    ));

    assert_eq!(into_values, from_values);

    Ok(())
}

#[test]
fn basic_read_write() {
    type Content = (u8, i8, i16, f32, [u8; 2], [i16; 2]);
    let mut buffer = [0u8; 14];

    let mut writer = TBytesWriter::from(buffer.as_mut_slice());

    let into_values: Content = (10, -20, 1048, 0.32, [10, 31], [-1, 240]);
    writer.write(into_values.0).unwrap();
    writer.write(into_values.1).unwrap();
    writer.write(into_values.2).unwrap();
    writer.write(into_values.3).unwrap();
    writer.write_slice(into_values.4.as_slice()).unwrap();
    writer.write_array(into_values.5).unwrap();

    assert!(matches!(writer.write(0u8), Err(TBytesError::OutOfBounds)));

    let reader = TBytesReader::from(buffer.as_slice());

    let mut from_values: Content = Content::default();
    from_values.0 = reader.read().unwrap();
    from_values.1 = reader.read().unwrap();
    from_values.2 = reader.read().unwrap();
    from_values.3 = reader.read().unwrap();
    from_values.4 = reader.read_array().unwrap();
    from_values.5 = reader.read_array().unwrap();

    assert!(matches!(
        reader.read() as Result<u8, TBytesError>,
        Err(TBytesError::OutOfBounds)
    ));

    assert_eq!(into_values, from_values);
}