Időzítő

Bevezetés

A timer osztály a brain alaposztályból származik, és funkciókat biztosít az eltelt idő mérésére, lehetővé téve az időtartamok nyomon követését és az időalapú események ütemezését egy VEX EXP programon belül.

Hozzáférés

Brain.Timer

Megjegyzések

• Brain.Timer a timer osztály egy példánya, és ugyanazt a funkcionalitást biztosítja.

Példa

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

// Create the EXP Brain
brain Brain = brain();

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

  wait(50, msec);
}

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 brain példányt, az alábbiak szerint:

// Create the EXP Brain
brain Brain = brain();

clear

Visszaállítja az időzítő aktuális értékét nullára. Ezután az időzítő azonnal újrakezdi a nulláról való felfelé számlálást.

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) {
  // Reset the timer every time the check button is pressed
  if (Brain.buttonCheck.pressing()) {
    Brain.Timer.clear();
  }
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Time: %.2f", Brain.Timer.value());
  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ő a projekt indulásakor kezd el számolni.

• 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", Brain.Timer.time());

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

  // Call turnOrange after 2 seconds
  Brain.Timer.event(turnOrange, 2000);
}