BooleanTopic.h

Go to the documentation of this file.

// Copyright (c) FIRST and other WPILib contributors.
// Open Source Software; you can modify and/or share it under the terms of
// the WPILib BSD license file in the root directory of this project.
 
// THIS FILE WAS AUTO-GENERATED BY ./ntcore/generate_topics.py. DO NOT MODIFY
 
#pragma once
 
#include <stdint.h>
 
 
#include <span>
#include <string_view>
#include <vector>
 
#include <wpi/json_fwd.h>
 
#include "networktables/NetworkTableType.h"
#include "networktables/Topic.h"
#include "ntcore_cpp.h"
 
namespace wpi {
template <typename T>
class SmallVectorImpl;
}  // namespace wpi
 
namespace nt {
 
class BooleanTopic;
 
/**
 * NetworkTables Boolean subscriber.
 */
class BooleanSubscriber : public Subscriber {
 public:
  using TopicType = BooleanTopic;
  using ValueType = bool;
  using ParamType = bool;
  using TimestampedValueType = TimestampedBoolean;
 
 
  BooleanSubscriber() = default;
 
  /**
   * Construct from a subscriber handle; recommended to use
   * BooleanTopic::Subscribe() instead.
   *
   * @param handle Native handle
   * @param defaultValue Default value
   */
  BooleanSubscriber(NT_Subscriber handle, ParamType defaultValue)
      : Subscriber{handle},
        m_defaultValue{defaultValue} {}
 
  /**
   * Get the last published value.
   * If no value has been published, returns the stored default value.
   *
   * @return value
   */
  ValueType Get() const {
    return Get(m_defaultValue);
  }
 
  /**
   * Get the last published value.
   * If no value has been published, returns the passed defaultValue.
   *
   * @param defaultValue default value to return if no value has been published
   * @return value
   */
  ValueType Get(ParamType defaultValue) const {
    return ::nt::GetBoolean(m_subHandle, defaultValue);
  }
 
  /**
   * Get the last published value along with its timestamp
   * If no value has been published, returns the stored default value and a
   * timestamp of 0.
   *
   * @return timestamped value
   */
  TimestampedValueType GetAtomic() const {
    return GetAtomic(m_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.
   *
   * @param defaultValue default value to return if no value has been published
   * @return timestamped value
   */
  TimestampedValueType GetAtomic(ParamType defaultValue) const {
    return ::nt::GetAtomicBoolean(m_subHandle, defaultValue);
  }
 
  /**
   * 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.
   *
   * @return Array of timestamped values; empty array if no new changes have
   *     been published since the previous call.
   */
  std::vector<TimestampedValueType> ReadQueue() {
    return ::nt::ReadQueueBoolean(m_subHandle);
  }
 
  /**
   * Get the corresponding topic.
   *
   * @return Topic
   */
  TopicType GetTopic() const;
 
 private:
  ValueType m_defaultValue;
};
 
/**
 * NetworkTables Boolean publisher.
 */
class BooleanPublisher : public Publisher {
 public:
  using TopicType = BooleanTopic;
  using ValueType = bool;
  using ParamType = bool;
 
  using TimestampedValueType = TimestampedBoolean;
 
  BooleanPublisher() = default;
 
  /**
   * Construct from a publisher handle; recommended to use
   * BooleanTopic::Publish() instead.
   *
   * @param handle Native handle
   */
  explicit BooleanPublisher(NT_Publisher handle) : Publisher{handle} {}
 
  /**
   * Publish a new value.
   *
   * @param value value to publish
   * @param time timestamp; 0 indicates current NT time should be used
   */
  void Set(ParamType value, int64_t time = 0) {
    ::nt::SetBoolean(m_pubHandle, value, time);
  }
 
  /**
   * Publish a default value.
   * On reconnect, a default value will never be used in preference to a
   * published value.
   *
   * @param value value
   */
  void SetDefault(ParamType value) {
    ::nt::SetDefaultBoolean(m_pubHandle, value);
  }
 
  /**
   * Get the corresponding topic.
   *
   * @return Topic
   */
  TopicType GetTopic() const;
};
 
/**
 * NetworkTables Boolean entry.
 *
 * @note Unlike NetworkTableEntry, the entry goes away when this is destroyed.
 */
class BooleanEntry final : public BooleanSubscriber,
                                  public BooleanPublisher {
 public:
  using SubscriberType = BooleanSubscriber;
  using PublisherType = BooleanPublisher;
  using TopicType = BooleanTopic;
  using ValueType = bool;
  using ParamType = bool;
 
  using TimestampedValueType = TimestampedBoolean;
 
  BooleanEntry() = default;
 
  /**
   * Construct from an entry handle; recommended to use
   * BooleanTopic::GetEntry() instead.
   *
   * @param handle Native handle
   * @param defaultValue Default value
   */
  BooleanEntry(NT_Entry handle, ParamType defaultValue)
      : BooleanSubscriber{handle, defaultValue},
        BooleanPublisher{handle} {}
 
  /**
   * Determines if the native handle is valid.
   *
   * @return True if the native handle is valid, false otherwise.
   */
  explicit operator bool() const { return m_subHandle != 0; }
 
  /**
   * Gets the native handle for the entry.
   *
   * @return Native handle
   */
  NT_Entry GetHandle() const { return m_subHandle; }
 
  /**
   * Get the corresponding topic.
   *
   * @return Topic
   */
  TopicType GetTopic() const;
 
  /**
   * Stops publishing the entry if it's published.
   */
  void Unpublish() {
    ::nt::Unpublish(m_pubHandle);
  }
};
 
/**
 * NetworkTables Boolean topic.
 */
class BooleanTopic final : public Topic {
 public:
  using SubscriberType = BooleanSubscriber;
  using PublisherType = BooleanPublisher;
  using EntryType = BooleanEntry;
  using ValueType = bool;
  using ParamType = bool;
  using TimestampedValueType = TimestampedBoolean;
  /** The default type string for this topic type. */
  static constexpr std::string_view kTypeString = "boolean";
 
  BooleanTopic() = default;
 
  /**
   * Construct from a topic handle; recommended to use
   * NetworkTableInstance::GetBooleanTopic() instead.
   *
   * @param handle Native handle
   */
  explicit BooleanTopic(NT_Topic handle) : Topic{handle} {}
 
  /**
   * Construct from a generic topic.
   *
   * @param topic Topic
   */
  explicit BooleanTopic(Topic topic) : Topic{topic} {}
 
  /**
   * Create a new subscriber to the topic.
   *
   * <p>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.
   *
   * @param defaultValue default value used when a default is not provided to a
   *        getter function
   * @param options subscribe options
   * @return subscriber
   */
  [[nodiscard]]
  SubscriberType Subscribe(
      ParamType defaultValue,
      const PubSubOptions& options = kDefaultPubSubOptions) {
    return BooleanSubscriber{
        ::nt::Subscribe(m_handle, NT_BOOLEAN, "boolean", options),
        defaultValue};
  }
  /**
   * Create a new subscriber to the topic, with specific type string.
   *
   * <p>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.
   *
   * @param typeString type string
   * @param defaultValue default value used when a default is not provided to a
   *        getter function
   * @param options subscribe options
   * @return subscriber
   */
  [[nodiscard]]
  SubscriberType SubscribeEx(
      std::string_view typeString, ParamType defaultValue,
      const PubSubOptions& options = kDefaultPubSubOptions) {
    return BooleanSubscriber{
        ::nt::Subscribe(m_handle, NT_BOOLEAN, typeString, options),
        defaultValue};
  }
 
  /**
   * 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.
   *
   * @param options publish options
   * @return publisher
   */
  [[nodiscard]]
  PublisherType Publish(const PubSubOptions& options = kDefaultPubSubOptions) {
    return BooleanPublisher{
        ::nt::Publish(m_handle, NT_BOOLEAN, "boolean", options)};
  }
 
  /**
   * 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.
   *
   * @param typeString type string
   * @param properties JSON properties
   * @param options publish options
   * @return publisher
   */
  [[nodiscard]]
  PublisherType PublishEx(std::string_view typeString,
    const wpi::json& properties, const PubSubOptions& options = kDefaultPubSubOptions) {
    return BooleanPublisher{
        ::nt::PublishEx(m_handle, NT_BOOLEAN, typeString, properties, options)};
  }
 
  /**
   * 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.
   *
   * @param defaultValue default value used when a default is not provided to a
   *        getter function
   * @param options publish and/or subscribe options
   * @return entry
   */
  [[nodiscard]]
  EntryType GetEntry(ParamType defaultValue,
                     const PubSubOptions& options = kDefaultPubSubOptions) {
    return BooleanEntry{
        ::nt::GetEntry(m_handle, NT_BOOLEAN, "boolean", options),
        defaultValue};
  }
  /**
   * Create a new entry for the topic, with specific type string.
   *
   * 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.
   *
   * @param typeString type string
   * @param defaultValue default value used when a default is not provided to a
   *        getter function
   * @param options publish and/or subscribe options
   * @return entry
   */
  [[nodiscard]]
  EntryType GetEntryEx(std::string_view typeString, ParamType defaultValue,
                       const PubSubOptions& options = kDefaultPubSubOptions) {
    return BooleanEntry{
        ::nt::GetEntry(m_handle, NT_BOOLEAN, typeString, options),
        defaultValue};
  }
 
};
 
inline BooleanTopic BooleanSubscriber::GetTopic() const {
  return BooleanTopic{::nt::GetTopicFromHandle(m_subHandle)};
}
 
inline BooleanTopic BooleanPublisher::GetTopic() const {
  return BooleanTopic{::nt::GetTopicFromHandle(m_pubHandle)};
}
 
inline BooleanTopic BooleanEntry::GetTopic() const {
  return BooleanTopic{::nt::GetTopicFromHandle(m_subHandle)};
}
 
}  // namespace nt