Struct cancellable_io::TcpListener

pub struct TcpListener { /* fields omitted */ }

A TCP socket server, listening for connections.

The socket will be closed when the value is dropped.

The accept and the incoming methods can be interrupted using the Canceller object created with the socket.

Otherwise similar to std::net::TcpListener.

Methods

impl TcpListener

pub fn bind<A: ToSocketAddrs>(address: A) -> Result<(Self, Canceller)>

Creates a new TcpListener which will be bound to the specified address, together with an object that allows cancelling accept operations.

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

Returns the local socket address of this listener.

pub fn try_clone(&self) -> Result<(Self, Canceller)>

Creates a new independently owned handle to the underlying socket.

pub fn accept(&self) -> Result<(TcpStream, Canceller, SocketAddr)>

Accepts a new incoming connection from this listener.

This method can be cancelled by the associated Canceller object.

This method returns a TcpStream with an associated Canceller and the address of the remote peer.

Important traits for Incoming<'a>

impl<'a> Iterator for Incoming<'a> type Item = Result<(TcpStream, Canceller, SocketAddr)>;

pub fn incoming(&self) -> Incoming

Returns an iterator over the connections being received by this listener.

The iteration can be cancelled by the associated Canceller object. If the iteration is cancelled, the next() method will return an error that can be identified with is_cancelled.

pub fn set_ttl(&self, ttl: u32) -> Result<()>

Sets the value for the IP_TTL option on this socket.

pub fn ttl(&self) -> Result<u32>

Gets the value for the IP_TTL option for this socket.

pub fn take_error(&self) -> Result<Option<Error>>

Gets the value for the SO_ERROR option for this socket.

pub fn set_nonblocking(&self, nonblocking: bool) -> Result<()>

Moves this TCP connection into or out of non blocking mode.

Trait Implementations

impl Debug for TcpListener

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

Formats the value using the given formatter.