oct 0.36.2

Octonary transcodings.
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

Both [`Serialise`] and [`Deserialise`] can be
derived for structures and enumerations:

[`Serialise`]: derive@oct::serdes::Serialise
[`Deserialise`]: derive@oct::serdes::Deserialise

```rust
use oct::serdes::{Deserialise, Serialise};

#[derive(Debug, Deserialise, PartialEq, Serialise)]
struct Struct0 {
	pub field0: char,
	pub field1: bool,
	pub field2: f64,
}

#[derive(Debug, Deserialise, PartialEq, Serialise)]
struct Struct1(pub i128);

#[derive(Debug, Deserialise, PartialEq, Serialise)]
struct Struct2;

#[derive(Debug, Deserialise, PartialEq, Serialise)]
enum Enum {
	Variant0 {
		field0: char,
		field1: bool,
		field2: f64,
	},

	Variant1(i128),

	Variant2,
}

const STRUCT0: Struct0 = Struct0 {
	field0: char::MAX,
	field1: true,
	field2: f64::MAX
};

const STRUCT1: Struct1 = Struct1(i128::MAX);

const STRUCT2: Struct2 = Struct2;

const ENUM_VARIANT0: Enum = Enum::Variant0 {
	field0: char::MAX,
	field1: true,
	field2: f64::MAX
};

const ENUM_VARIANT1: Enum = Enum::Variant1(i128::MAX);

const ENUM_VARIANT2: Enum = Enum::Variant2;

let mut buf = [0; 1024];

let mut output = buf.as_mut_slice();

STRUCT0.serialise(&mut output).unwrap();
STRUCT1.serialise(&mut output).unwrap();
STRUCT2.serialise(&mut output).unwrap();
ENUM_VARIANT0.serialise(&mut output).unwrap();
ENUM_VARIANT1.serialise(&mut output).unwrap();
ENUM_VARIANT2.serialise(&mut output).unwrap();

let mut input = buf.as_slice();

assert_eq!(Struct0::deserialise(&mut input).unwrap(), STRUCT0);
assert_eq!(Struct1::deserialise(&mut input).unwrap(), STRUCT1);
assert_eq!(Struct2::deserialise(&mut input).unwrap(), STRUCT2);
assert_eq!(Enum::deserialise(&mut input).unwrap(), ENUM_VARIANT0);
assert_eq!(Enum::deserialise(&mut input).unwrap(), ENUM_VARIANT1);
assert_eq!(Enum::deserialise(&mut input).unwrap(), ENUM_VARIANT2);
```

Untagged unions, however, cannot derive them:

```rust,compile_fail
use oct::io::{Deserialise, Serialise};

#[derive(Deserialise, Serialise)]
union Union {}
```