WPILibC++
2019.1.1-beta-1-5-g9a1af13
|
Timer objects measure accumulated time in seconds. More...
#include <Timer.h>
Public Member Functions | |
Timer () | |
Create a new timer object. More... | |
Timer (Timer &&)=default | |
Timer & | operator= (Timer &&)=default |
double | Get () const |
Get the current time from the timer. More... | |
void | Reset () |
Reset the timer by setting the time to 0. More... | |
void | Start () |
Start the timer running. More... | |
void | Stop () |
Stop the timer. More... | |
bool | HasPeriodPassed (double period) |
Check if the period specified has passed and if it has, advance the start time by that period. More... | |
Static Public Member Functions | |
static double | GetFPGATimestamp () |
Return the FPGA system clock time in seconds. More... | |
static double | GetMatchTime () |
Return the approximate match time. More... | |
Static Public Attributes | |
static const double | kRolloverTime |
Timer objects measure accumulated time in seconds.
The timer object functions like a stopwatch. It can be started, stopped, and cleared. When the timer is running its value counts up in seconds. When stopped, the timer holds the current value. The implementation simply records the time when started and subtracts the current time whenever the value is requested.
frc::Timer::Timer | ( | ) |
Create a new timer object.
Create a new timer object and reset the time to zero. The timer is initially not running and must be started.
double frc::Timer::Get | ( | ) | const |
Get the current time from the timer.
If the clock is running it is derived from the current system clock the start time stored in the timer class. If the clock is not running, then return the time when it was last stopped.
|
static |
Return the FPGA system clock time in seconds.
Return the time from the FPGA hardware clock in seconds since the FPGA started. Rolls over after 71 minutes.
|
static |
Return the approximate match time.
The FMS does not send an official match time to the robots, but does send an approximate match time. The value will count down the time remaining in the current period (auto or teleop).
Warning: This is not an official time (so it cannot be used to dispute ref calls or guarantee that a function will trigger before the match ends).
The Practice Match function of the DS approximates the behavior seen on the field.
bool frc::Timer::HasPeriodPassed | ( | double | period | ) |
Check if the period specified has passed and if it has, advance the start time by that period.
This is useful to decide if it's time to do periodic work without drifting later by the time it took to get around to checking.
period | The period to check for (in seconds). |
void frc::Timer::Reset | ( | ) |
Reset the timer by setting the time to 0.
Make the timer startTime the current time so new requests will be relative to now.
void frc::Timer::Start | ( | ) |
Start the timer running.
Just set the running flag to true indicating that all time requests should be relative to the system clock.
void frc::Timer::Stop | ( | ) |
Stop the timer.
This computes the time as of now and clears the running flag, causing all subsequent time requests to be read from the accumulated time rather than looking at the system clock.