nng_socket_id(3)

nng_socket_id3

Return numeric socket identifier

Usage

#include <nng/nng.h>
int nng_socket_id(nng_socket s);

Overview

The nng_socket_id() function returns a positive identifier for the socket s, if it is valid. Otherwise it returns -1.

Note

A socket is considered valid if it was ever opened with a protocol constructor, such as the nng_req0_open() function. Sockets that are allocated on the stack or statically should be initialized with the macro NNG_SOCKET_INITIALIZER to ensure that they cannot be confused with a valid socket before they are opened.

Return values

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

Errors

None.

From libnng-dev 1.10.1-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.