#include <nng/nng.h>
int nng_stream_dialer_alloc(nng_stream_dialer **dp, const char *addr);
int nng_stream_dialer_alloc_url(nng_stream_dialer **dp, const nng_url *url);
This documentation is for version v1.7.2 of NNG, but the latest released version is v1.8.0. see the documentation for v1.8.0 for the most up-to-date information. |
nng_stream_dialer_alloc(3str)
NAME
nng_stream_dialer_alloc - allocate byte stream dialer
SYNOPSIS
DESCRIPTION
These functions allocates a dialer for byte streams.
Dialers create
nng_stream
objects by initiating outgoing
connections, via the
nng_stream_dialer_dial()
function.
The first form, nng_stream_dialer_alloc()
, connects to the address
specified by addr, which should be a string representing a URL.
The second form, nng_stream_dialer_alloc_url()
, takes a pre-parsed
or pre-constructed
nng_url
object to determine the remote address.
These functions may support different URL schemes, such as
ipc://
, tcp://
, tls+tcp://
, or ws://
.
Both forms store the dialer in the location referenced by dp.
RETURN VALUES
These functions return 0 on success, and non-zero otherwise.
ERRORS
NNG_ENOMEM
|
Insufficient free memory exists. |
NNG_ENOTSUP
|
The URL scheme is not supported by the implementation. |
NNG_EADDRINVAL
|
The URL requested is invalid. |