Timer#

Introduktion#

Timerklassen timer används för att hålla tiden och interagera med en timer oberoende av Hjärnans timer.

Klasskonstruktor#

timer();

Klassförstörare#

Förstör timer objektet och frigör tillhörande resurser.

~timer();

Parametrar#

Denna konstruktor accepterar inga parametrar.

Exempel#

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

Medlemsfunktioner#

Klassen timer innehåller följande medlemsfunktioner:

  • reset — Resets the timer to zero.

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

  • event — Anropar en funktion efter ett angivet antal millisekunder, med valfria argument.

Innan några timer medlemsfunktioner anropas måste en timer instans skapas, som visas nedan:

/* 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#

Ställer in timern på noll.

Available Functions
void reset();

Parameters

Den här funktionen accepterar inga parametrar.

Return Values

Den här funktionen returnerar inget värde.

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#

Returnerar timerns aktuella värde.

Available Functions
double value();

Parameters

Den här funktionen accepterar inga parametrar.

Return Values

En dubbel som representerar den tid som gått i sekunder.

Notes
  • Timern börjar räkna när timern är konstruerad.

  • 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#

Registrerar en återuppringningsfunktion som ska köras efter en angiven fördröjning.

Available Functions

1 — Registrerar en återanropsfunktion som ska köras efter en angiven fördröjning och skickar ett användardefinierat värde till återanropsfunktionen.

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

2 — Registrerar ett återanrop som ska köras efter en angiven fördröjning.

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

Parameters

Parameter

Typ

Beskrivning

callback

void (*)(void *)

En funktion som anropas efter den angivna fördröjningen och tar emot ett användardefinierat argument.

callback

void (*)(void)

En funktion som kommer att anropas efter den angivna fördröjningen.

value

uint32_t

Fördröjningen, i millisekunder, innan återuppringningsfunktionen körs.

Return Values

Den här funktionen returnerar inget värde.

Notes
  • Den här funktionen schemalägger ett engångsåteruppringning; den upprepas inte automatiskt.

  • Återanropsfunktionen måste returnera void.

  • Flera evenemang kan vara schemalagda samtidigt.

Examples

Definiera funktionen (utanför int main())

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

Registrera funktionen inuti 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);
}