IntegerArray Functions

Functions
bool	nt::SetIntegerArray (NT_Handle pubentry, std::span< const int64_t > value, int64_t time=0)
	Publish a new value.
bool	nt::SetDefaultIntegerArray (NT_Handle pubentry, std::span< const int64_t > defaultValue)
	Publish a default value.
std::vector< int64_t >	nt::GetIntegerArray (NT_Handle subentry, std::span< const int64_t > defaultValue)
	Get the last published value.
TimestampedIntegerArray	nt::GetAtomicIntegerArray (NT_Handle subentry, std::span< const int64_t > defaultValue)
	Get the last published value along with its timestamp.
std::vector< TimestampedIntegerArray >	nt::ReadQueueIntegerArray (NT_Handle subentry)
	Get an array of all value changes since the last call to ReadQueue.
std::vector< std::vector< int64_t > >	nt::ReadQueueValuesIntegerArray (NT_Handle subentry)
	Get an array of all value changes since the last call to ReadQueue.
std::span< int64_t >	nt::GetIntegerArray (NT_Handle subentry, wpi::SmallVectorImpl< int64_t > &buf, std::span< const int64_t > defaultValue)
TimestampedIntegerArrayView	nt::GetAtomicIntegerArray (NT_Handle subentry, wpi::SmallVectorImpl< int64_t > &buf, std::span< const int64_t > defaultValue)

Detailed Description

Function Documentation

GetAtomicIntegerArray() [1/2]

TimestampedIntegerArray nt::GetAtomicIntegerArray	(	NT_Handle	subentry,
		std::span< const int64_t >	defaultValue )

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

Returns

timestamped value

GetAtomicIntegerArray() [2/2]

TimestampedIntegerArrayView nt::GetAtomicIntegerArray	(	NT_Handle	subentry,
		wpi::SmallVectorImpl< int64_t > &	buf,
		std::span< const int64_t >	defaultValue )

GetIntegerArray() [1/2]

std::vector< int64_t > nt::GetIntegerArray	(	NT_Handle	subentry,
		std::span< const int64_t >	defaultValue )

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

Returns

value

GetIntegerArray() [2/2]

std::span< int64_t > nt::GetIntegerArray	(	NT_Handle	subentry,
		wpi::SmallVectorImpl< int64_t > &	buf,
		std::span< const int64_t >	defaultValue )

ReadQueueIntegerArray()

std::vector< TimestampedIntegerArray > nt::ReadQueueIntegerArray

(

NT_Handle

subentry

)

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

Returns

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

ReadQueueValuesIntegerArray()

std::vector< std::vector< int64_t > > nt::ReadQueueValuesIntegerArray

(

NT_Handle

subentry

)

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

Note

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

Parameters

subentry

subscriber or entry handle

Returns

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

SetDefaultIntegerArray()

bool nt::SetDefaultIntegerArray	(	NT_Handle	pubentry,
		std::span< const int64_t >	defaultValue )

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

SetIntegerArray()

bool nt::SetIntegerArray	(	NT_Handle	pubentry,
		std::span< const int64_t >	value,
		int64_t	time = 0 )

Publish a new value.

Parameters

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