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.7.3. See the documentation for v1.7.3 for the most up-to-date information.

nng_listener_id(3)

NAME

nng_listener_id - return numeric listener identifier

SYNOPSIS

#include <nng/nng.h>

int nng_listener_id(nng_listener l);

DESCRIPTION

The nng_listener_id() function returns a positive identifier for the listener l, if it is valid. Otherwise it returns -1.

A listener is considered valid if it was ever created with the nng_listener_create() or nng_listen() functions. listeners that are allocated on the stack or statically should be initialized with the macro NNG_LISTENER_INITIALIZER to ensure that they cannot be confused with a valid listener before they are created properly.

RETURN VALUES

This function returns the positive value for the listener identifier, or -1 if the listener is invalid.

ERRORS

None.

SEE ALSO