7 releases (4 breaking)
0.5.1 | Apr 21, 2024 |
---|---|
0.5.0 | Apr 1, 2024 |
0.4.0 | Jan 13, 2024 |
0.3.1 | Nov 29, 2023 |
0.1.0 | Sep 5, 2023 |
#1545 in Rust patterns
47 downloads per month
Used in 6 crates
(4 directly)
73KB
1K
SLoC
IROX-STRUCTS
Traits for Struct Types - linearly serialized big/little endian bytes
A very simple 'Struct' library that provides a single trait. This is intended to be most
generally used in concert with irox_structs_derive
to generate the impls.
A Struct is a linear sequence in memory of serialized bytes - serialized in the order the fields are present in the struct with no adjacency or packing.
Strict Sizing
By default, irox_structs_derive
will allow variably sized types like String
and Vec<u8>
.
If you know you don't need/use these, apply a #[strict_sizing]
attribute, and the generator
will add a pub const STRUCT_SIZE: usize
to the struct
Choosing Endianness:
Apply either the #[big_endian]
or #[little_endian]
attributes when deriving Struct
and
it will use the appropriate serializers. If not specified, it defaults to big endian.
Example Big Endian:
use irox_structs::Struct;
use irox_tools::bits::Error;
#[derive(Default, Debug, Copy, Clone, Eq, PartialEq, Struct)]
#[strict_sizing]
pub struct UdpHeader {
source_port: u16,
dest_port: u16,
length: u16,
checksum: u16,
}
pub fn main() -> Result<(), Error> {
assert_eq!(8, UdpHeader::STRUCT_SIZE);
let header = UdpHeader {
source_port: 0x0064,
dest_port: 0x0400,
length: 0x1388,
checksum: 0x01C2,
};
let mut output_buf: Vec<u8> = Vec::new();
header.write_to(&mut output_buf)?;
assert_eq!(output_buf.len(), 8);
assert_eq!(&[0x00u8, 0x64, 0x04, 0x00, 0x13, 0x88, 0x01, 0xC2],
output_buf.as_slice());
let parsed = UdpHeader::parse_from(&mut output_buf.as_slice())?;
assert_eq!(header, parsed);
Ok(())
}
Example Little Endian:
use irox_structs::Struct;
use irox_tools::bits::Error;
#[derive(Default, Debug, Copy, Clone, Eq, PartialEq, Struct)]
#[little_endian]
#[strict_sizing]
pub struct UdpHeader {
source_port: u16,
dest_port: u16,
length: u16,
checksum: u16,
}
pub fn main() -> Result<(), Error> {
assert_eq!(8, UdpHeader::STRUCT_SIZE);
let header = UdpHeader {
source_port: 0x0064,
dest_port: 0x0400,
length: 0x1388,
checksum: 0x01C2,
};
let mut output_buf: Vec<u8> = Vec::new();
header.write_to(&mut output_buf)?;
assert_eq!(output_buf.len(), 8);
assert_eq!(&[0x64u8, 0x00, 0x00, 0x04, 0x88, 0x13, 0xC2, 0x01],
output_buf.as_slice());
let parsed = UdpHeader::parse_from(&mut output_buf.as_slice())?;
assert_eq!(header, parsed);
Ok(())
}
No-STD support:
- Fully no-std compliant
Features:
- None
Modules:
Module | [no_std] ? |
|
---|---|---|
irox_structs |
Contains the 'Struct' type |
Dependencies
~0.6–1MB
~23K SLoC