Vlastní časovač

Zavedení

Třída timer se používá k měření času a interakci s časovačem nezávislým na Brainově časovači.

Konstruktor třídy

timer();

Destruktor tříd

Zničí objekt časovače timer a uvolní přidružené zdroje.

~timer();

Parametry

Tento konstruktor nepřijímá žádné parametry.

Příklady

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

Členské funkce

Třída timer obsahuje následující členské funkce:

• clear — Vynuluje časovač.

• time — Vrátí uplynulý čas od spuštění časovače.

• event — Volá funkci po zadaném počtu milisekund s volitelnými argumenty.

Před voláním jakékoli členské funkce timer musí být vytvořena instance timer , jak je znázorněno níže:

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

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

clear

Nastaví časovač na nulu.

Available Functions

void clear();

Parameters

Tato funkce nepřijímá žádné parametry.

Return Values

Tato funkce nevrací hodnotu.

Examples

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

time

Vrátí aktuální hodnotu časovače.

Available Functions

1 — Vrátí uplynulý čas v milisekundách.

uint32_t time() const;

2 — Vrátí uplynulý čas v zadaných časových jednotkách.

double time(
    timeUnits units ) const;

Parameters

Parametr	Typ	Popis
units	timeUnits	Jednotky použité k vrácení uplynulého času: seconds / sec sekund msec milisekund

Return Values

• Bezparametrická funkce (1) vrací hodnotu uint32_t která představuje uplynulý čas v milisekundách.

• Funkce s parametrem timeUnits (2) vrací hodnotu double představující uplynulý čas v zadaných jednotkách.

Notes

• Časovač začne odpočítávat, jakmile je vytvořen vlastní časovač.

• Voláním clear se hodnota časovače vynuluje.

Examples

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

  wait(50, msec);
}

event

Registruje funkci zpětného volání, která se má provést po zadané prodlevě.

Available Functions

1 — Zaregistruje zpětné volání, které se spustí po zadaném zpoždění, a předá zpětnému volání uživatelem definovanou hodnotu.

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

2 — Zaregistruje zpětné volání, které se spustí po zadané prodlevě.

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

Parameters

Parametr	Typ	Popis
callback	void (*)(void *)	Funkce, která bude volána po zadané prodlevě a obdrží uživatelem definovaný argument.
callback	void (*)(void)	Funkce, která bude volána po uplynutí zadané prodlevy.
value	uint32_t	Zpoždění v milisekundách před provedením funkce zpětného volání.

Return Values

Tato funkce nevrací hodnotu.

Notes

• Tato funkce naplánuje jednorázové zpětné volání; neopakuje se automaticky.

• Funkce zpětného volání musí vrátit void.

• Více akcí může být naplánováno současně.

Examples

Definujte funkci (mimo int main())

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

Zaregistrujte funkci uvnitř 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);
}