Struct UdpListener

pub struct UdpListener { /* private fields */ }

An I/O object representing a UDP socket listening for incoming connections.

This object can be converted into a stream of incoming connections for various forms of processing.

Examples

async fn process_socket<T>(_socket: T) {}

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let mut listener = UdpListener::bind(SocketAddr::from_str("127.0.0.1:8080")?).await?;

    loop {
        let (socket, _) = listener.accept().await?;
        process_socket(socket).await;
    }
}

Implementations

impl UdpListener

pub async fn bind<A: ToSocketAddrs>(addr: A) -> Result<Self, Error>

Usage is exactly the same as tokio::net::TcpListener::bind

pub fn local_addr(&self) -> Result<SocketAddr>

Returns the local address that this socket is bound to.

pub async fn accept(&self) -> Result<(UdpStream, SocketAddr)>

Accepts a new incoming UDP connection.

Trait Implementations

impl Drop for UdpListener

fn drop(&mut self)

Executes the destructor for this type.