Struct nng::Listener [−][src]
pub struct Listener { /* fields omitted */ }
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
impl Listener
[src]
impl Listener
[src]pub fn new(socket: &Socket, url: &str) -> Result<Self>
[src]
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.
pub fn close(self)
[src]
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
impl GetOpt<RecvBufferSize> for Listener
[src]
impl GetOpt<RecvBufferSize> for Listener
[src]impl GetOpt<RecvTimeout> for Listener
[src]
impl GetOpt<RecvTimeout> for Listener
[src]impl GetOpt<ResendTime> for Listener
[src]
impl GetOpt<ResendTime> for Listener
[src]impl GetOpt<SendBufferSize> for Listener
[src]
impl GetOpt<SendBufferSize> for Listener
[src]impl GetOpt<SendTimeout> for Listener
[src]
impl GetOpt<SendTimeout> for Listener
[src]impl GetOpt<SocketName> for Listener
[src]
impl GetOpt<SocketName> for Listener
[src]impl GetOpt<SurveyTime> for Listener
[src]
impl GetOpt<SurveyTime> for Listener
[src]impl PartialOrd<Listener> for Listener
[src]
impl PartialOrd<Listener> for Listener
[src]Auto Trait Implementations
impl RefUnwindSafe for Listener
impl RefUnwindSafe for Listener
impl UnwindSafe for Listener
impl UnwindSafe for Listener