Struct nng::Dialer [−][src]
pub struct Dialer { /* fields omitted */ }
Expand description
An active outgoing connection.
A Dialer
is responsible for establishing and maintaining outgoing
connections. If a connection is ever broken, or fails, the Dialer
object
automatically attempts to reconnect.
Directly creating a Dialer
is only necessary when one wishes to
configure the connection before opening it or if one wants to close the
outgoing connection without closing the socket. Otherwise, Socket::dial
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 dialer object associated with the given socket.
Note that this will immediately start the dialer so no configuration
will be possible. Use DialerBuilder
to change the dialer options
before starting it.
Errors
AddressInvalid
: An invalid url was specified.Closed
: The socket is not open.ConnectionRefused
: The remote peer refused the connection.ConnectionReset
: The remote peer reset the connection.DestUnreachable
: The remote address is not reachable.OutOfMemory
: Insufficient memory is available.PeerAuth
: Authentication or authorization failure.Protocol
: A protocol error occurred.
Closes the dialer.
This also closes any Pipe
objects that have been created by the
dialer. Once this function returns, the dialer has been closed and all
of its resources have been deallocated. Therefore, any attempt to
utilize the dialer (with this or any other handle) will result in
an error.
Dialers are implicitly closed when the socket they are associated with is closed. Dialers 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 Dialer
impl UnwindSafe for Dialer
Blanket Implementations
Mutably borrows from an owned value. Read more