Struct TcpListener

pub struct TcpListener { /* private fields */ }

Available on non-WASI only.

A TCP socket server, listening for connections.

This corresponds to std::net::TcpListener.

This TcpListener has no bind method. To bind it to a socket address, first obtain a Pool permitting the address, and then call Pool::bind_tcp_listener.

Implementations

impl TcpListener

pub fn from_std(std: TcpListener) -> Self

Constructs a new instance of Self from the given std::net::TcpListener.

This grants access the resources the std::net::TcpListener instance already has access to.

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

Returns the local socket address of this listener.

This corresponds to std::net::TcpListener::local_addr.

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

Creates a new independently owned handle to the underlying socket.

This corresponds to std::net::TcpListener::try_clone.

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

Accept a new incoming connection from this listener.

This corresponds to std::net::TcpListener::accept.

pub fn incoming(&self) -> Incoming<'_>

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

This corresponds to std::net::TcpListener::incoming.

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

Sets the value for the IP_TTL option on this socket.

This corresponds to std::net::TcpListener::set_ttl.

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

Gets the value of the IP_TTL option for this socket.

This corresponds to std::net::TcpListener::ttl.

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

Gets the value of the SO_ERROR option on this socket.

This corresponds to std::net::TcpListener::take_error.

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

Moves this TCP stream into or out of nonblocking mode.

This corresponds to std::net::TcpListener::set_nonblocking.

Trait Implementations

impl AsHandleOrSocket for TcpListener

Available on Windows only.

fn as_handle_or_socket(&self) -> BorrowedHandleOrSocket<'_>

Like AsHandle::as_handle and AsSocket::as_socket but can return either type.

impl AsRawHandleOrSocket for TcpListener

Available on Windows only.

fn as_raw_handle_or_socket(&self) -> RawHandleOrSocket

Like AsRawHandle::as_raw_handle and AsRawSocket::as_raw_socket but can return either type.

impl AsRawSocket for TcpListener

Available on Windows only.

fn as_raw_socket(&self) -> RawSocket

Extracts the raw socket.

impl AsSocket for TcpListener

Available on Windows only.

fn as_socket(&self) -> BorrowedSocket<'_>

Borrows the socket.

impl Debug for TcpListener

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

Formats the value using the given formatter.

impl From<OwnedSocket> for TcpListener

Available on Windows only.

fn from(socket: OwnedSocket) -> Self

Converts to this type from the input type.

impl From<TcpListener> for OwnedHandleOrSocket

Available on Windows only.

fn from(listener: TcpListener) -> Self

Converts to this type from the input type.

impl From<TcpListener> for OwnedSocket

Available on Windows only.

fn from(listener: TcpListener) -> OwnedSocket

Converts to this type from the input type.

impl FromRawSocket for TcpListener

Available on Windows only.

unsafe fn from_raw_socket(socket: RawSocket) -> Self

Constructs a new I/O object from the specified raw socket.

impl IntoRawHandleOrSocket for TcpListener

Available on Windows only.

fn into_raw_handle_or_socket(self) -> RawHandleOrSocket

Like IntoRawHandle::into_raw_handle and IntoRawSocket::into_raw_socket but can return either type.

impl IntoRawSocket for TcpListener

Available on Windows only.

fn into_raw_socket(self) -> RawSocket

Consumes this object, returning the raw underlying socket.

impl SocketlikeViewType for TcpListener