Timer#

Invoering#

De timer klasse wordt gebruikt om de tijd bij te houden en te interageren met een timer die onafhankelijk is van de Brain’s timer.

Klasseconstructor#

timer();

Klasse-destructor#

Vernietigt het timer object en geeft de bijbehorende resources vrij.

~timer();

Parameters#

Deze constructor accepteert geen parameters.

Voorbeelden#

// Create a timer instance
timer myTimer = timer();

Lidfuncties#

De klasse timer bevat de volgende lidfuncties:

  • reset — Resets the timer to zero.

  • value — Returns the elapsed time since the timer started.

  • event — Roept een functie aan na een opgegeven aantal milliseconden, met optionele argumenten.

Voordat er lidfuncties van timer worden aangeroepen, moet er een instantie van timer worden aangemaakt, zoals hieronder weergegeven:

/* This constructor is required to use a 
custom timer. Replace the values
as needed. */

// Create a timer instance
timer myTimer = timer();

/* This constructor is required when using VS Code.
A Brain is generated automatically at the start of
VEXcode projects. */

// Create the Brain to use Brain.Timer
brain Brain = brain();

reset#

Zet de timer op nul.

Available Functions
void reset();

Parameters

Deze functie accepteert geen parameters.

Return Values

Deze functie retourneert geen waarde.

Examples
while (true) {
  // Clear the timer every time the screen is pressed
  if (Brain.Screen.pressing()) {
    myTimer.reset();
  }
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Time: %.2f", myTimer.value());
  wait(50, msec);
}

value#

Geeft de huidige waarde van de timer terug.

Available Functions
double value();

Parameters

Deze functie accepteert geen parameters.

Return Values

Een double die de verstreken tijd in seconden weergeeft.

Notes
  • De timer begint te tellen zodra de timer is geconstrueerd.

  • Calling reset resets the timer value to zero.

Examples
// Display the timer as it ticks up
while (true) {
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Time: %.2f", myTimer.value());

  wait(50, msec);
}

event#

Registreert een callbackfunctie die na een bepaalde vertraging moet worden uitgevoerd.

Available Functions

1 — Registreert een callback die na een bepaalde vertraging wordt uitgevoerd en geeft een door de gebruiker gedefinieerde waarde door aan de callback.

static void event(
    void (*callback)(void *),
    uint32_t value );

2 — Registreert een callback die na een bepaalde vertraging wordt uitgevoerd.

static void event(
    void (*callback)(void),
    uint32_t value );

Parameters

Parameter

Type

Beschrijving

callback

void (*)(void *)

Een functie die na de opgegeven vertraging wordt aangeroepen en een door de gebruiker gedefinieerd argument ontvangt.

callback

void (*)(void)

Een functie die na de opgegeven vertraging wordt aangeroepen.

value

uint32_t

De vertraging, in milliseconden, voordat de callbackfunctie wordt uitgevoerd.

Return Values

Deze functie retourneert geen waarde.

Notes
  • Deze functie plant een eenmalige callback in; deze wordt niet automatisch herhaald.

  • De callbackfunctie moet void retourneren.

  • Er kunnen meerdere evenementen tegelijkertijd worden ingepland.

Examples

Definieer de functie (buiten int main())

// Create a function to turn the screen orange
void turnOrange() {
  Brain.Screen.clearScreen(orange);
}

Registreer de functie binnen int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  timer myTimer = timer();
  // Call turnOrange after 2 seconds
  myTimer.event(turnOrange, 2000);
}