Struct smoltcp::storage::PacketBuffer

pub struct PacketBuffer<'a, 'b, H: 'a> { /* private fields */ }

An UDP packet ring buffer.

Implementations

impl<'a, 'b, H> PacketBuffer<'a, 'b, H>

pub fn new<MS, PS>(
    metadata_storage: MS,
    payload_storage: PS
) -> PacketBuffer<'a, 'b, H>where
    MS: Into<ManagedSlice<'a, PacketMetadata<H>>>,
    PS: Into<ManagedSlice<'b, u8>>,

Create a new packet buffer with the provided metadata and payload storage.

Metadata storage limits the maximum number of packets in the buffer and payload storage limits the maximum total size of packets.

pub fn is_empty(&self) -> bool

Query whether the buffer is empty.

pub fn is_full(&self) -> bool

Query whether the buffer is full.

pub fn enqueue(&mut self, size: usize, header: H) -> Result<&mut [u8]>

Enqueue a single packet with the given header into the buffer, and return a reference to its payload, or return Err(Error::Exhausted) if the buffer is full, or return Err(Error::Truncated) if the buffer does not have enough spare payload space.

pub fn dequeue_with<'c, R, F>(&'c mut self, f: F) -> Result<R>where
    F: FnOnce(&mut H, &'c mut [u8]) -> Result<R>,

Call f with a single packet from the buffer, and dequeue the packet if f returns successfully, or return Err(Error::Exhausted) if the buffer is empty.

pub fn dequeue(&mut self) -> Result<(H, &mut [u8])>

Dequeue a single packet from the buffer, and return a reference to its payload as well as its header, or return Err(Error::Exhausted) if the buffer is empty.

Trait Implementations

impl<'a, 'b, H: Debug + 'a> Debug for PacketBuffer<'a, 'b, H>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.