C Interface

The header file nxLibFunctions.h provides a basic set of functions to read and write nodes of the parameter tree.

NxLib interface functions always take a path to an item in the tree to operate on. Arrays and objects can be read/written element wise, or by using the functions with the suffix “Json”. They return or write an entire subtree via its JSON representation.

Note

Some of the library’s internal nodes are read only and cannot be modified or deleted. You can see the corresponding permissions in NxTreeEdit.

Please refer to the subtopics:

• Reading node values

• Writing node values

• Waiting for specific values or changes

• Asynchronous watching for specific values or changes

• Other functions

Finding the C Interface

The headers and the import library (on Windows) for NxLib and NxLibRemote can be found in the directory $ENSENSO_INSTALL/development/c/.

On Linux you can use the following CMake snippets to set up the include path and link NxLib or NxLibRemote:

find_package(NxLib CONFIG REQUIRED)
target_link_libraries(<YOUR TARGET> PRIVATE NxLib::NxLib)

find_package(NxLibRemote CONFIG REQUIRED)
target_link_libraries(<YOUR TARGET> PRIVATE NxLibRemote::NxLibRemote)