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