Crate podio

Additional methods for Read and Write

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

Usage

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

Examples

Reading

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);

Writing

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);

writer.write_u16::<LittleEndian>(0x8802).unwrap();

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]);
assert!(reader.read_exact(1).is_err());

Enums

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

Traits

Endianness	Trait to determine the conversion methods for a specific endianness
ReadPodExt	Additional read methods for a io::Read
WritePodExt	Additional write methods for a io::Write