Egyéni időzítő

Bevezetés

A timer osztály az idő mérésére és az agy időzítőjétől független időzítővel való interakcióra szolgál.

Osztálykonstruktor

timer();

Osztálydestruktor

Megsemmisíti a timer objektumot és felszabadítja a hozzá tartozó erőforrásokat.

~timer();

Paraméterek

Ez a konstruktor nem fogad el paramétereket.

Példák

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

Tagfüggvények

A timer osztály a következő tagfüggvényeket tartalmazza:

• clear — Nullára állítja az időzítőt.

• time — Visszaadja az időzítő indítása óta eltelt időt.

• event — Megadott számú ezredmásodperc elteltével meghív egy függvényt, opcionális argumentumokkal.

Bármely timer tagfüggvény meghívása előtt létre kell hozni egy timer példányt, az alábbiak szerint:

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

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

clear

Nullára állítja az időzítőt.

Available Functions

void clear();

Parameters

Ez a függvény nem fogad el paramétereket.

Return Values

Ez a függvény nem ad vissza értéket.

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

Visszaadja az időzítő aktuális értékét.

Available Functions

1 — Visszaadja az eltelt időt milliszekundumban.

uint32_t time() const;

2 — Visszaadja az eltelt időt a megadott időegységben.

double time(
    timeUnits units ) const;

Parameters

Paraméter	Típus	Leírás
units	timeUnits	Az eltelt idő visszaadásához használt mértékegységek: seconds / sec — másodperc msec — milliszekundum

Return Values

• A paraméter nélküli függvény (1) egy uint32_t értéket ad vissza, amely az eltelt időt jelöli milliszekundumban.

• A timeUnits paraméterrel (2) rendelkező függvény egy double értéket ad vissza, amely a megadott egységben eltelt időt jelöli.

Notes

• Az időzítő akkor kezd el számolni, amikor az egyéni időzítő elkészül.

• A clear függvény meghívása nullára állítja vissza az időzítő értékét.

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

Visszahívó függvényt regisztrál, amely egy megadott késleltetés után végrehajtódik.

Available Functions

1 — Visszahívást regisztrál, amely egy megadott késleltetés után fut, és egy felhasználó által definiált értéket átad a visszahívásnak.

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

2 — Visszahívást regisztrál, amely egy megadott késleltetés után fut.

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

Parameters

Paraméter	Típus	Leírás
callback	void (*)(void *)	Egy függvény, amely a megadott késleltetés után meghívódik, és egy felhasználó által definiált argumentumot kap.
callback	void (*)(void)	Egy függvény, amely a megadott késleltetés után meghívódik.
value	uint32_t	A visszahívó függvény végrehajtása előtti késleltetés milliszekundumban.

Return Values

Ez a függvény nem ad vissza értéket.

Notes

• Ez a függvény egyszeri visszahívást ütemez; nem ismétlődik automatikusan.

• A visszahívó függvénynek void értéket kell visszaadnia.

• Több esemény is ütemezhető egyszerre.

Examples

Definiáld a függvényt ( int main())

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

Regisztráld a függvényt a int main() karakterláncon belül

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);
}