Struct TcpListener 

pub struct TcpListener { /* private fields */ }

Listening endpoint for inbound TCP connections.

Holding this alive keeps the bound socket open; dropping it closes the socket (the OS releases the port).

Implementations

impl TcpListener

pub fn bind(scheme: &str, host: &str, port: u16) -> Result<Self>

Bind a new listener at host:port, honoring the address-family hint tcp4 / tcp6 / tcp encoded in scheme. Passing port 0 requests an ephemeral port from the OS; the caller can read the assigned port back via local_addr.

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

The locally-bound socket address. Useful for reading back the OS-assigned ephemeral port after binding with port 0.

Trait Implementations

impl Drop for TcpListener

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Listener for TcpListener

fn accept(&mut self) -> Result<Box<dyn Transport>>

Block until a peer connects, then return the new transport.