NetworkTables protobuf-encoded value topic. More...

#include <networktables/ProtobufTopic.h>

Inheritance diagram for nt::ProtobufTopic< T >:

Public Types
using	SubscriberType = ProtobufSubscriber< T >

using	PublisherType = ProtobufPublisher< T >

using	EntryType = ProtobufEntry< T >

using	ValueType = T

using	ParamType = const T &

using	TimestampedValueType = Timestamped< T >

Public Member Functions
	ProtobufTopic ()=default

	ProtobufTopic (NT_Topic handle)
	Construct from a topic handle; recommended to use NetworkTableInstance::GetProtobufTopic() instead. More...

	ProtobufTopic (Topic topic)
	Construct from a generic topic. More...

SubscriberType	Subscribe (T defaultValue, const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new subscriber to the topic. More...

PublisherType	Publish (const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new publisher to the topic. More...

PublisherType	PublishEx (const wpi::json &properties, const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new publisher to the topic, with type string and initial properties. More...

EntryType	GetEntry (T defaultValue, const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new entry for the topic. More...

Public Member Functions inherited from nt::Topic
	Topic ()=default

	Topic (NT_Topic handle)

	operator bool () const
	Determines if the native handle is valid. More...

NT_Topic	GetHandle () const
	Gets the native handle for the topic. More...

NetworkTableInstance	GetInstance () const
	Gets the instance for the topic. More...

std::string	GetName () const
	Gets the name of the topic. More...

NetworkTableType	GetType () const
	Gets the type of the topic. More...

std::string	GetTypeString () const
	Gets the type string of the topic. More...

void	SetPersistent (bool persistent)
	Make value persistent through server restarts. More...

bool	IsPersistent () const
	Returns whether the value is persistent through server restarts. More...

void	SetRetained (bool retained)
	Make the server retain the topic even when there are no publishers. More...

bool	IsRetained () const
	Returns whether the topic is retained by server when there are no publishers. More...

void	SetCached (bool cached)
	Allow storage of the topic's last value, allowing the value to be read (and not just accessed through event queues and listeners). More...

bool	IsCached () const
	Returns whether the topic's last value is stored. More...

bool	Exists () const
	Determines if the topic is currently being published. More...

wpi::json	GetProperty (std::string_view name) const
	Gets the current value of a property (as a JSON object). More...

void	SetProperty (std::string_view name, const wpi::json &value)
	Sets a property value. More...

void	DeleteProperty (std::string_view name)
	Deletes a property. More...

wpi::json	GetProperties () const
	Gets all topic properties as a JSON object. More...

bool	SetProperties (const wpi::json &properties)
	Updates multiple topic properties. More...

TopicInfo	GetInfo () const
	Gets combined information about the topic. More...

GenericSubscriber	GenericSubscribe (const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new subscriber to the topic. More...

GenericSubscriber	GenericSubscribe (std::string_view typeString, const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new subscriber to the topic. More...

GenericPublisher	GenericPublish (std::string_view typeString, const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new publisher to the topic. More...

GenericPublisher	GenericPublishEx (std::string_view typeString, const wpi::json &properties, const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new publisher to the topic, with type string and initial properties. More...

GenericEntry	GetGenericEntry (const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new generic entry for the topic. More...

GenericEntry	GetGenericEntry (std::string_view typeString, const PubSubOptions &options=kDefaultPubSubOptions)
	Create a new generic entry for the topic. More...

bool	operator== (const Topic &) const =default
	Equality operator. More...

Additional Inherited Members
Protected Attributes inherited from nt::Topic
NT_Topic	m_handle {0}

Detailed Description

template<wpi::ProtobufSerializable T>
class nt::ProtobufTopic< T >

NetworkTables protobuf-encoded value topic.

Member Typedef Documentation

◆ EntryType

template<wpi::ProtobufSerializable T>

using nt::ProtobufTopic< T >::EntryType = ProtobufEntry<T>

◆ ParamType

template<wpi::ProtobufSerializable T>

using nt::ProtobufTopic< T >::ParamType = const T&

◆ PublisherType

template<wpi::ProtobufSerializable T>

using nt::ProtobufTopic< T >::PublisherType = ProtobufPublisher<T>

◆ SubscriberType

template<wpi::ProtobufSerializable T>

using nt::ProtobufTopic< T >::SubscriberType = ProtobufSubscriber<T>

◆ TimestampedValueType

template<wpi::ProtobufSerializable T>

using nt::ProtobufTopic< T >::TimestampedValueType = Timestamped<T>

◆ ValueType

template<wpi::ProtobufSerializable T>

using nt::ProtobufTopic< T >::ValueType = T

Constructor & Destructor Documentation

◆ ProtobufTopic() [1/3]

template<wpi::ProtobufSerializable T>

nt::ProtobufTopic< T >::ProtobufTopic ( )

default

◆ ProtobufTopic() [2/3]

template<wpi::ProtobufSerializable T>

nt::ProtobufTopic< T >::ProtobufTopic ( NT_Topic handle )

inlineexplicit

Construct from a topic handle; recommended to use NetworkTableInstance::GetProtobufTopic() instead.

Parameters

handle Native handle

◆ ProtobufTopic() [3/3]

template<wpi::ProtobufSerializable T>

nt::ProtobufTopic< T >::ProtobufTopic ( Topic topic )

inlineexplicit

Construct from a generic topic.

Parameters

topic Topic

Member Function Documentation

◆ GetEntry()

template<wpi::ProtobufSerializable T>

EntryType nt::ProtobufTopic< T >::GetEntry	(	T	defaultValue,
		const PubSubOptions &	options = `kDefaultPubSubOptions`
	)

inline

Create a new entry for the topic.

Entries act as a combination of a subscriber and a weak publisher. The subscriber is active as long as the entry is not destroyed. The publisher is created when the entry is first written to, and remains active until either Unpublish() is called or the entry is destroyed.

Note: It is not possible to use two different data types with the same topic. Conflicts between publishers are typically resolved by the server on a first-come, first-served basis. Any published values that do not match the topic's data type are dropped (ignored), and the entry will show no new values if the data type does not match. To determine if the data type matches, use the appropriate Topic functions.

Parameters

defaultValue	default value used when a default is not provided to a getter function
options	publish and/or subscribe options

Returns: entry

◆ Publish()

template<wpi::ProtobufSerializable T>

PublisherType nt::ProtobufTopic< T >::Publish ( const PubSubOptions & options = kDefaultPubSubOptions )

inline

Create a new publisher to the topic.

The publisher is only active as long as the returned object is not destroyed.

Note: It is not possible to publish two different data types to the same topic. Conflicts between publishers are typically resolved by the server on a first-come, first-served basis. Any published values that do not match the topic's data type are dropped (ignored). To determine if the data type matches, use the appropriate Topic functions.

Parameters

options publish options

Returns: publisher

◆ PublishEx()

template<wpi::ProtobufSerializable T>

PublisherType nt::ProtobufTopic< T >::PublishEx	(	const wpi::json &	properties,
		const PubSubOptions &	options = `kDefaultPubSubOptions`
	)

inline

Create a new publisher to the topic, with type string and initial properties.

The publisher is only active as long as the returned object is not destroyed.

Note: It is not possible to publish two different data types to the same topic. Conflicts between publishers are typically resolved by the server on a first-come, first-served basis. Any published values that do not match the topic's data type are dropped (ignored). To determine if the data type matches, use the appropriate Topic functions.

Parameters

properties	JSON properties
options	publish options

Returns: publisher

◆ Subscribe()

template<wpi::ProtobufSerializable T>

SubscriberType nt::ProtobufTopic< T >::Subscribe	(	T	defaultValue,
		const PubSubOptions &	options = `kDefaultPubSubOptions`
	)

inline

Create a new subscriber to the topic.

The subscriber is only active as long as the returned object is not destroyed.

Note: Subscribers that do not match the published data type do not return any values. To determine if the data type matches, use the appropriate Topic functions.

Parameters

defaultValue	default value used when a default is not provided to a getter function
options	subscribe options

Returns: subscriber

The documentation for this class was generated from the following file:

networktables/ProtobufTopic.h

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ EntryType

◆ ParamType

◆ PublisherType

◆ SubscriberType

◆ TimestampedValueType

◆ ValueType

Constructor & Destructor Documentation

◆ ProtobufTopic() [1/3]

◆ ProtobufTopic() [2/3]

◆ ProtobufTopic() [3/3]

Member Function Documentation

◆ GetEntry()

◆ Publish()

◆ PublishEx()

◆ Subscribe()