Struct de_net::protocol::ProtocolSocket

pub(crate) struct ProtocolSocket {
    socket: Arc<Socket>,
}

A thin layer over a UDP socket translating between UDP datagrams and header-payload pairs.

Fields

socket: Arc<Socket>

Implementations

impl ProtocolSocket

pub(crate) fn new(socket: Socket) -> Self

pub(crate) async fn send( &self, header: DatagramHeader, buf: &mut [u8], target: SocketAddr ) -> Result<(), SendError>

Send data to a list of targets.

The sending is done in parallel.

Arguments

• buf - buffer used for datagram construction. First HEADER_SIZE bytes are overwritten with the header. Payload bytes must follow.

• header - header of the datagram.

• data - datagram payload.

• target - recipient of the datagram.

pub(crate) async fn recv<'a>( &self, buf: &'a mut [u8] ) -> Result<(SocketAddr, DatagramHeader, &'a [u8]), MsgRecvError>

Receive a single datagram.

Arguments

• buf - the data is written to this buffer. The buffer must be at least MAX_DATAGRAM_SIZE long.

Returns

Return source address, datagram header and a slice with the payload. Header data are not included in the payload slice.

Panics

Panics if len of buf is smaller than MAX_DATAGRAM_SIZE.

Trait Implementations

impl Clone for ProtocolSocket

fn clone(&self) -> ProtocolSocket

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.