#include <nng/nng.h> typedef struct nng_pipe_s nng_pipe;
|This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. The latest released version is v1.3.2. See the documentation for v1.3.2 for the most up-to-date information.|
nng_pipe - communications pipe
nng_pipe is a handle to a pipe object, which can be thought of as a single
(In most cases this is actually the case -- the pipe is an abstraction for a
single TCP or IPC connection.)
Pipes are associated with either the listener or dialer that created them,
and therefore are also automatically associated with a single socket.
|Most applications should never concern themselves with individual pipes. However it is possible to access a pipe when more information about the source of a message is needed, or when more control is required over message delivery.|
Pipe objects may be destroyed by the
They are also closed when the dialer or listener that created them is closed,
or when the remote peer closes the underlying connection.
A pipe may be initialized using the macro
before it is opened, to prevent confusion with valid open pipes.
nng_pipe p = NNG_PIPE_INITIALIZER;