BooleanArray Functions

Functions
NT_Bool	NT_SetBooleanArray (NT_Handle pubentry, int64_t time, const NT_Bool *value, size_t len)
	Publish a new value.
NT_Bool	NT_SetDefaultBooleanArray (NT_Handle pubentry, const NT_Bool *defaultValue, size_t defaultValueLen)
	Publish a default value.
NT_Bool *	NT_GetBooleanArray (NT_Handle subentry, const NT_Bool *defaultValue, size_t defaultValueLen, size_t *len)
	Get the last published value.
void	NT_GetAtomicBooleanArray (NT_Handle subentry, const NT_Bool *defaultValue, size_t defaultValueLen, struct NT_TimestampedBooleanArray *value)
	Get the last published value along with its timestamp.
void	NT_DisposeTimestampedBooleanArray (struct NT_TimestampedBooleanArray *value)
	Disposes a timestamped value (as returned by NT_GetAtomicBooleanArray).
struct NT_TimestampedBooleanArray *	NT_ReadQueueBooleanArray (NT_Handle subentry, size_t *len)
	Get an array of all value changes since the last call to ReadQueue.
void	NT_FreeQueueBooleanArray (struct NT_TimestampedBooleanArray *arr, size_t len)
	Frees a timestamped array of values (as returned by NT_ReadQueueBooleanArray).

Detailed Description

Function Documentation

NT_DisposeTimestampedBooleanArray()

void NT_DisposeTimestampedBooleanArray

(

struct NT_TimestampedBooleanArray *

value

)

Disposes a timestamped value (as returned by NT_GetAtomicBooleanArray).

Parameters

value

timestamped value

NT_FreeQueueBooleanArray()

void NT_FreeQueueBooleanArray	(	struct NT_TimestampedBooleanArray *	arr,
		size_t	len )

Frees a timestamped array of values (as returned by NT_ReadQueueBooleanArray).

Parameters

arr	array
len	length of array

NT_GetAtomicBooleanArray()

void NT_GetAtomicBooleanArray	(	NT_Handle	subentry,
		const NT_Bool *	defaultValue,
		size_t	defaultValueLen,
		struct NT_TimestampedBooleanArray *	value )

Get the last published value along with its timestamp.

If no value has been published, returns the passed defaultValue and a timestamp of 0.

Parameters

subentry	subscriber or entry handle
defaultValue	default value to return if no value has been published
defaultValueLen	length of default value
value	timestamped value (output)

NT_GetBooleanArray()

NT_Bool * NT_GetBooleanArray	(	NT_Handle	subentry,
		const NT_Bool *	defaultValue,
		size_t	defaultValueLen,
		size_t *	len )

Get the last published value.

If no value has been published, returns the passed defaultValue.

Parameters

subentry	subscriber or entry handle
defaultValue	default value to return if no value has been published
defaultValueLen	length of default value
len	length of returned value (output)

Returns

value

NT_ReadQueueBooleanArray()

struct NT_TimestampedBooleanArray * NT_ReadQueueBooleanArray	(	NT_Handle	subentry,
		size_t *	len )

Get an array of all value changes since the last call to ReadQueue.

Also provides a timestamp for each value.

Note

The "poll storage" subscribe option can be used to set the queue depth.

Parameters

subentry	subscriber or entry handle
len	length of returned array (output)

Returns

Array of timestamped values; NULL if no new changes have been published since the previous call.

NT_SetBooleanArray()

NT_Bool NT_SetBooleanArray	(	NT_Handle	pubentry,
		int64_t	time,
		const NT_Bool *	value,
		size_t	len )

Publish a new value.

Parameters

pubentry	publisher or entry handle
time	timestamp; 0 indicates current NT time should be used
value	value to publish
len	length of value

NT_SetDefaultBooleanArray()

NT_Bool NT_SetDefaultBooleanArray	(	NT_Handle	pubentry,
		const NT_Bool *	defaultValue,
		size_t	defaultValueLen )

Publish a default value.

On reconnect, a default value will never be used in preference to a published value.

Parameters

pubentry	publisher or entry handle
defaultValue	default value
defaultValueLen	length of default value