Struct nng::Listener [−][src]
pub struct Listener { /* fields omitted */ }
Expand description
Active listener for incoming connections.
A Listener
is the object that is responsible for accepting incoming
connections. A given Listener
can have many connections to multiple
clients simultaneously. Directly creating a listener object is only
necessary when one wishes to configure the listener before opening it or if
one wants to close the connections without closing the socket. Otherwise,
Socket::listen
can be used.
Note that the client/server relationship described by a dialer/listener is completely orthogonal to any similar relationship in the protocols. For example, a rep socket may use a dialer to connect to a listener on a req socket. This orthogonality can lead to innovative solutions to otherwise challenging communications problems.
See the NNG documentation for more information.
Implementations
Creates a new listener object associated with the given socket.
Note that this will immediately start the listener so no configuration
will be possible. Use ListenerBuilder
to change the listener options
before starting it.
Errors
AddressInUse
: The address specified by url is already in use.Addressinvalid
: An invalid url was specified.Closed
: The socket is not open.OutOfMemory
: Insufficient memory is available.
Closes the listener.
This also closes any Pipe
objects that have been created by the
listener. Once this function returns, the listener has been closed and
all of its resources have been deallocated. Therefore, any attempt to
utilize the listener (with this or any other handle) will result in an
error.
Listeners are implicitly closed when the socket they are associated with is closed. Listeners are not closed when all handles are dropped.
Trait Implementations
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
Auto Trait Implementations
impl RefUnwindSafe for Listener
impl UnwindSafe for Listener
Blanket Implementations
Mutably borrows from an owned value. Read more