logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

nng_dialer_create - create dialer

Description

       The 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.

           Tip

           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 the nng_dialer_setopt() family of
       functions.

       Once it is fully configured, the dialer may be started using the nng_dialer_start() function.

           Tip

           If no specific configuration is required, consider using the simpler nng_dial() function instead.

Errors

       NNG_EADDRINVAL
           An invalid url was specified.

       NNG_ECLOSED
           The socket s is not open.

       NNG_ENOMEM
           Insufficient memory is available.

Name

       nng_dialer_create - create dialer

Return Values

       This function returns 0 on success, and non-zero otherwise.

See Also

nng_dial(3), nng_dialer_close(3), nng_dialer_getopt(3), nng_dialer_setopt(3), nng_dialer_start(3),
       nng_listener_create(3) nng_strerror(3), nng_dialer(5), nng(7)

                                                   2025-04-20                               NNG_DIALER_CREATE(3)

Synopsis

           #include <nng/nng.h>

           int nng_dialer_create(nng_dialer *dialerp, nng_socket s, const char *url);

See Also