WPILibC++ 2025.2.1
Loading...
Searching...
No Matches
wpi::log::StringLogEntry Class Reference

Log string values. More...

#include <wpi/DataLog.h>

Inheritance diagram for wpi::log::StringLogEntry:
wpi::log::DataLogValueEntryImpl< std::string > wpi::log::DataLogEntry

Public Member Functions

 StringLogEntry ()=default
 
 StringLogEntry (DataLog &log, std::string_view name, int64_t timestamp=0)
 
 StringLogEntry (DataLog &log, std::string_view name, std::string_view metadata, int64_t timestamp=0)
 
 StringLogEntry (DataLog &log, std::string_view name, std::string_view metadata, std::string_view type, int64_t timestamp=0)
 
void Append (std::string_view value, int64_t timestamp=0)
 Appends a record to the log.
 
void Update (std::string_view value, int64_t timestamp=0)
 Updates the last value and appends a record to the log if it has changed.
 
- Public Member Functions inherited from wpi::log::DataLogValueEntryImpl< std::string >
 DataLogValueEntryImpl (DataLogValueEntryImpl &&rhs)
 
DataLogValueEntryImploperator= (DataLogValueEntryImpl &&rhs)
 
bool HasLastValue () const
 Gets whether there is a last value.
 
std::optional< std::string > GetLastValue () const
 Gets the last value.
 
- Public Member Functions inherited from wpi::log::DataLogEntry
 DataLogEntry (const DataLogEntry &)=delete
 
DataLogEntryoperator= (const DataLogEntry &)=delete
 
 DataLogEntry (DataLogEntry &&rhs)
 
DataLogEntryoperator= (DataLogEntry &&rhs)
 
 operator bool () const
 
void SetMetadata (std::string_view metadata, int64_t timestamp=0)
 Updates the metadata for the entry.
 
void Finish (int64_t timestamp=0)
 Finishes the entry.
 

Static Public Attributes

static constexpr const char * kDataType = "string"
 

Additional Inherited Members

- Protected Member Functions inherited from wpi::log::DataLogValueEntryImpl< std::string >
 DataLogValueEntryImpl ()=default
 
 DataLogValueEntryImpl (DataLog &log, std::string_view name, std::string_view type, std::string_view metadata={}, int64_t timestamp=0)
 
- Protected Member Functions inherited from wpi::log::DataLogEntry
 DataLogEntry ()=default
 
 DataLogEntry (DataLog &log, std::string_view name, std::string_view type, std::string_view metadata={}, int64_t timestamp=0)
 
- Protected Attributes inherited from wpi::log::DataLogValueEntryImpl< std::string >
wpi::mutex m_mutex
 
std::optional< std::string > m_lastValue
 
- Protected Attributes inherited from wpi::log::DataLogEntry
DataLogm_log = nullptr
 
int m_entry = 0
 

Detailed Description

Log string values.

Constructor & Destructor Documentation

◆ StringLogEntry() [1/4]

wpi::log::StringLogEntry::StringLogEntry ( )
default

◆ StringLogEntry() [2/4]

wpi::log::StringLogEntry::StringLogEntry ( DataLog & log,
std::string_view name,
int64_t timestamp = 0 )
inline

◆ StringLogEntry() [3/4]

wpi::log::StringLogEntry::StringLogEntry ( DataLog & log,
std::string_view name,
std::string_view metadata,
int64_t timestamp = 0 )
inline

◆ StringLogEntry() [4/4]

wpi::log::StringLogEntry::StringLogEntry ( DataLog & log,
std::string_view name,
std::string_view metadata,
std::string_view type,
int64_t timestamp = 0 )
inline

Member Function Documentation

◆ Append()

void wpi::log::StringLogEntry::Append ( std::string_view value,
int64_t timestamp = 0 )
inline

Appends a record to the log.

Parameters
valueValue to record
timestampTime stamp (may be 0 to indicate now)

◆ Update()

void wpi::log::StringLogEntry::Update ( std::string_view value,
int64_t timestamp = 0 )
inline

Updates the last value and appends a record to the log if it has changed.

Note
The last value is local to this class instance; using Update() with two instances pointing to the same underlying log entry name will likely result in unexpected results.
Parameters
valueValue to record
timestampTime stamp (may be 0 to indicate now)

Member Data Documentation

◆ kDataType

const char* wpi::log::StringLogEntry::kDataType = "string"
staticconstexpr

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