GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NN_SYMBOL (3)

.ds Aq ’

NAME

nn_symbol - query the names and values of nanomsg symbols

CONTENTS

SYNOPSIS

#include <nanomsg/nn.h>

const char *nn_symbol (int i, int *value);

DESCRIPTION

Retrieves the symbol name and value at index i. Indices start at 0. An index has no significance to its associated symbol; the mappings may change between library versions.

Typically a client will iterate through the symbols until nn_symbol returns NULL in order to collect all the symbols.

All symbols exposed by nn_symbol are available directly in the C API, generally as preprocessor macros. Thus, this function is useful mostly for language bindings that can\(cqt parse the header file and rely on retrieving the symbols in the runtime.

Note that the NN_MSG symbol is not exported by the nn_symbol function. First, it is a pointer rather than an integer; second, the symbol is not supposed to be exported from language bindings to the user. Instead, language bindings should provide the zero-copy functionality in a language-specific way, if at all (zero-copy functionality may not make sense for some languages/bindings).

RETURN VALUE

If i is valid, returns the name of the symbol at that index. If the pointer value is not NULL, the symbol\(cqs value is stored there.

If i is out-of-range, nn_symbol returns NULL and sets errno to EINVAL.

ERRORS

EINVAL

The passed index i was out-of-range; it was less than zero or greater-than-or- equal-to the number of symbols.

EXAMPLE

int value, i;
for (i = 0; ; ++i) {
    const char* name = nn_symbol (i, &value);
    if (name == NULL) break;
    printf ("%s = %d\n", name, value);
}

SEE ALSO

nn_symbol_info(3) nn_errno(3) nn_strerror(3) nanomsg(7)

AUTHORS

Evan Wies <\m[blue]evan@neomantra.net\m[][1]>

NOTES

1. evan@neomantra.net  mailto:evan@neomantra.net
Search for    or go to Top of page |  Section 3 |  Main Index


nanomsg Unknown NN_SYMBOL (3) 03/17/2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.