Utility Functions

Functions
void	NT_DisposeValue (struct NT_Value *value)
	Frees value memory.
void	NT_InitValue (struct NT_Value *value)
	Initializes a NT_Value.
void	NT_DisposeValueArray (struct NT_Value *arr, size_t count)
	Frees an array of NT_Values.
void	NT_DisposeConnectionInfoArray (struct NT_ConnectionInfo *arr, size_t count)
	Disposes a connection info array.
void	NT_DisposeTopicInfoArray (struct NT_TopicInfo *arr, size_t count)
	Disposes a topic info array.
void	NT_DisposeTopicInfo (struct NT_TopicInfo *info)
	Disposes a single topic info (as returned by NT_GetTopicInfo).
void	NT_DisposeEventArray (struct NT_Event *arr, size_t count)
	Disposes an event array.
void	NT_DisposeEvent (struct NT_Event *event)
	Disposes a single event.
int64_t	NT_Now (void)
	Returns monotonic current time in 1 us increments.
void	NT_SetNow (int64_t timestamp)
	Sets the current timestamp used for timestamping values that do not provide a timestamp (e.g.

Detailed Description

Function Documentation

NT_DisposeConnectionInfoArray()

void NT_DisposeConnectionInfoArray	(	struct NT_ConnectionInfo *	arr,
		size_t	count )

Disposes a connection info array.

Parameters

arr	pointer to the array to dispose
count	number of elements in the array

NT_DisposeEvent()

void NT_DisposeEvent

(

struct NT_Event *

event

)

Disposes a single event.

Parameters

event

pointer to the event to dispose

NT_DisposeEventArray()

void NT_DisposeEventArray	(	struct NT_Event *	arr,
		size_t	count )

Disposes an event array.

Parameters

arr	pointer to the array to dispose
count	number of elements in the array

NT_DisposeTopicInfo()

void NT_DisposeTopicInfo

(

struct NT_TopicInfo *

info

)

Disposes a single topic info (as returned by NT_GetTopicInfo).

Parameters

info	pointer to the info to dispose

NT_DisposeTopicInfoArray()

void NT_DisposeTopicInfoArray	(	struct NT_TopicInfo *	arr,
		size_t	count )

Disposes a topic info array.

Parameters

arr	pointer to the array to dispose
count	number of elements in the array

NT_DisposeValue()

void NT_DisposeValue

(

struct NT_Value *

value

)

Frees value memory.

Parameters

value

value to free

NT_DisposeValueArray()

void NT_DisposeValueArray	(	struct NT_Value *	arr,
		size_t	count )

Frees an array of NT_Values.

Parameters

arr	pointer to the value array to free
count	number of elements in the array

Note that the individual NT_Values in the array should NOT be freed before calling this. This function will free all the values individually.

NT_InitValue()

void NT_InitValue

(

struct NT_Value *

value

)

Initializes a NT_Value.

Sets type to NT_UNASSIGNED and clears rest of struct.

Parameters

value

value to initialize

NT_Now()

int64_t NT_Now

(

void

)

Returns monotonic current time in 1 us increments.

This is the same time base used for entry and connection timestamps. This function by default simply wraps WPI_Now(), but if NT_SetNow() is called, this function instead returns the value passed to NT_SetNow(); this can be used to reduce overhead.

Returns

Timestamp

NT_SetNow()

void NT_SetNow

(

int64_t

timestamp

)

Sets the current timestamp used for timestamping values that do not provide a timestamp (e.g.

a value of 0 is passed). For consistency, it also results in NT_Now() returning the set value. This should generally be used only if the overhead of calling WPI_Now() is a concern. If used, it should be called periodically with the value of WPI_Now().

Parameters

timestamp

timestamp (1 us increments)