#include <nng/nng.h> int nng_dialer_create(nng_dialer *dialerp, nng_socket s, const char *url);
nng_dialer_create - create dialer
nng_dialer_create() function creates a newly initialized
nng_dialer object, associated with socket s,
and configured to connect to the
address specified by url, and stores a pointer to at the location
referenced by dialerp.
Dialers initiate a remote connection to a listener. Upon a successful connection being established, they create a pipe, add it to the socket, and then wait for that pipe to be closed. When the pipe is closed, they will re-initiate the connection. Dialers will also periodically retry a connection automatically if an attempt to connect asynchronously fails.
|While it is convenient to think of dialers as clients, the relationship between the listener or dialer is orthogonal to any server or client status that might be associated with a given protocol. For example, a req socket might have associated dialers, but might also have associated listeners. It may even have some of each at the same time!|
The dialer is not started, but may be further configured with
nng_dialer_setopt() family of functions.
Once it is fully configured, the dialer may be started using the
If no specific configuration is required, consider using the
This function returns 0 on success, and non-zero otherwise.
An invalid url was specified.
The socket s is not open.
Insufficient memory is available.