Crate podio

source ·
Expand description

Additional methods for Read and Write

The additional methods implemented allow reading and writing integers and floats in the specified endianness.


Basically, you need to use the trait WritePodExt or ReadPodExt.



To read some value from a reader, import ReadPodExt and the needed endianness.

use podio::{ReadPodExt, BigEndian};

let slice: &[u8] = &[0x10, 0x20, 0x30, 0x40];
let mut reader = std::io::Cursor::new(slice);

let value = reader.read_u32::<BigEndian>().unwrap();

assert_eq!(value, 0x10203040);


For writing, you need to import the trait WritePodExt.

use podio::{WritePodExt, LittleEndian};

let slice: &mut [u8] = &mut [0; 2];
let mut writer = std::io::Cursor::new(slice);


assert_eq!(writer.into_inner(), &[0x02, 0x88]);

Read exact

One additional method, not really dealing with POD, is read_exact.

use podio::ReadPodExt;

let slice: &[u8] = &[0, 1, 2, 3];
let mut reader = std::io::Cursor::new(slice);

assert_eq!(reader.read_exact(1).unwrap(), [0]);
assert_eq!(reader.read_exact(2).unwrap(), [1,2]);
assert_eq!(reader.read_exact(0).unwrap(), []);
assert_eq!(reader.read_exact(1).unwrap(), [3]);


Big endian. The number 0xABCD is stored [0xAB, 0xCD]
Little endian. The number 0xABCD is stored [0xCD, 0xAB]


Generic trait for endian conversions on integers
Trait implementing conversion methods for a specific endianness
Additional read methods for a io::Read
Additional write methods for a io::Write