typedef struct nng_listener_s nng_listener;
nng_listener is a handle to a “listener” object, which is responsible for
nng_pipe objects by accepting incoming connections.
A given listener object may create many pipes at the same time, much like an
HTTP server can have many connections to multiple clients simultaneously.
nng_listener structure is always passed by value (both
for input parameters and return values), and should be treated opaquely.
Passing structures this way gives the compiler a chance to perform
accurate type checks in functions passing values of this type.
nng_socket may have multiple listener
objects, multiple dialer objects, or even some
|The client/server relationship described by 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 an req socket. This orthogonality can lead to innovative solutions to otherwise challenging communications problems.
Listener objects may be destroyed by the
They are also closed when their “owning” socket is closed.
A listener may be initialized using the macro
before it is opened, to prevent confusion with valid open listener.