stdto 0.14.0

Stdto provides a set of functional traits for conversion between various data representations.
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

#![allow(clippy::needless_update)]

use std::{collections::BTreeMap, error::Error, io::Cursor};

use stdto::prelude::*;

#[stdto::bytes(endian = "big")]
struct Test {
    a: u32,
    b: String,
    c: [u8; 32],
    d: Vec<u8>,
    e: BTreeMap<u8, f64>,
}

fn main() -> Result<(), Box<dyn Error>> {
    let origin = Test {
        a: 1,
        b: "test".to_string(),
        c: [5; 32],
        d: vec![3; 32],
        e: BTreeMap::new(),
    };

    let mut bytes: Vec<u8>;

    bytes = origin.to_bytes();
    Test::from_bytes(&bytes);

    bytes.clear();

    bytes = origin.try_to_bytes()?;
    Test::try_from_bytes(&bytes)?;

    bytes.clear();

    origin.to_bytes_into(&mut bytes);
    Test::from_bytes_from(bytes.as_slice());

    bytes.clear();

    origin.try_to_bytes_into(&mut bytes)?;
    Test::try_from_bytes_from(bytes.as_slice())?;

    Test::from_bytes(bytes);

    let be_bytes = origin.to_be_bytes();
    let le_bytes = origin.to_le_bytes();
    assert_ne!(be_bytes, le_bytes);

    test_custom()?;

    let s = "Hello world".to_string();
    let as_bytes = s.as_byte_slice();
    assert_eq!(as_bytes, s.as_bytes());

    let bytes = s.to_bytes();
    let bytes2 = s.as_bytes().to_vec();
    let bytes3 = s.into_bytes();
    assert_eq!(bytes, bytes2);
    assert_eq!(bytes, bytes3);

    let arr = [1u8, 2, 3, 4, 5];
    let bytes = arr.to_bytes();
    let bytes2 = arr.to_vec();
    assert_eq!(bytes, bytes2);

    Ok(())
}

#[stdto::serde]
struct Custom {
    a: u32,
    b: String,
    c: [u8; 32],
    d: Vec<u8>,
    e: BTreeMap<u8, f64>,
}

use stdto::{Endian, ToBytesOptions};

// custom options
impl ToBytes for Custom {
    const OPTIONS: ToBytesOptions = ToBytesOptions {
        endian: Endian::Big,
        ..ToBytesOptions::default()
    };
}

fn test_custom() -> Result<(), Box<dyn Error>> {
    let origin = Custom {
        a: 1,
        b: "test".to_string(),
        c: [5; 32],
        d: vec![3; 32],
        e: BTreeMap::new(),
    };

    let mut bytes: Vec<u8>;

    bytes = origin.to_bytes();
    Custom::from_bytes(&bytes);

    bytes.clear();

    bytes = origin.try_to_bytes()?;
    Custom::try_from_bytes(&bytes)?;

    bytes.clear();

    origin.to_bytes_into(&mut bytes);
    Custom::from_bytes_from(&mut Cursor::new(&bytes));

    bytes.clear();

    origin.try_to_bytes_into(&mut bytes)?;
    Custom::try_from_bytes_from(&mut Cursor::new(&bytes))?;

    let be_bytes = origin.to_be_bytes();
    let le_bytes = origin.to_le_bytes();
    assert_ne!(be_bytes, le_bytes);

    Ok(())
}