DecodeWithKey

Trait DecodeWithKey 

Source
pub trait DecodeWithKey: Sized {
    type Key;

    // Required method
    fn decode(
        key: Self::Key,
        src: &mut BytesMut,
        length: usize,
    ) -> Result<(Self, usize), DecodeError>;
}
Available on crate feature alloc only.
Expand description

Trait for decoding SMPP values from a buffer with a specified key and length.

§Implementation


#[derive(Debug, PartialEq, Eq)]
enum Foo {
    A(u16),
    B(AnyOctetString),
}

impl DecodeWithKey for Foo {
    type Key = u32;

    fn decode(key: Self::Key, src: &mut BytesMut, length: usize) -> Result<(Self, usize), DecodeError> {
        match key {
            0x01020304 => {
                let (a, size) = Decode::decode(src)?;

                Ok((Foo::A(a), size))
            }
            0x04030201 => {
                let (b, size) = AnyOctetString::decode(src, length)?;

                Ok((Foo::B(b), size))
            }
            _ => Err(DecodeError::unsupported_key(key)),
        }
    }
}

// Received over the wire
let length = 8;

// Key is A
let mut buf = BytesMut::from(&[
    0x01, 0x02, 0x03, 0x04, // Key
    0x05, 0x06, // Value
    0x07, 0x08, 0x09, 0x0A, 0x0B, // Rest
][..]);

let index = 0;

let (key, size) = Decode::decode(&mut buf).unwrap();
let index = index + size;

let (foo, size) = Foo::decode(key, &mut buf, length - index).unwrap();
let index = index + size;

let expected = Foo::A(0x0506);

assert_eq!(size, 2);
assert_eq!(foo, expected);
assert_eq!(&buf[..], &[0x07, 0x08, 0x09, 0x0A, 0x0B]);

// Received over the wire
let length = 8;

// Key is B
let mut buf = BytesMut::from(&[
    0x04, 0x03, 0x02, 0x01, // Key
    0x05, 0x06, 0x07, 0x08, // Value
    0x09, 0x0A, 0x0B, // Rest
][..]);

let index = 0;

let (key, size) = Decode::decode(&mut buf).unwrap();
let index = index + size;

let (foo, size) = Foo::decode(key, &mut buf, length - index).unwrap();
let index = index + size;

let expected = Foo::B(AnyOctetString::from_static_slice(&[0x05, 0x06, 0x07, 0x08]));

assert_eq!(size, 4);
assert_eq!(foo, expected);
assert_eq!(&buf[..], &[0x09, 0x0A, 0x0B]);

Required Associated Types§

Required Methods§

Source

fn decode( key: Self::Key, src: &mut BytesMut, length: usize, ) -> Result<(Self, usize), DecodeError>

Decode a value from a buffer, using a key to determine the type.

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors§