Pengatur waktu#

Perkenalan#

Kelas timer diturunkan dari kelas dasar brain dan menyediakan fungsionalitas untuk mengukur waktu yang telah berlalu, memungkinkan Anda untuk melacak durasi dan menjadwalkan peristiwa berbasis waktu dalam program VEX V5.

Mengakses#

Brain.Timer

Catatan#

  • Brain.Timer adalah sebuah instance dari kelas timer dan menyediakan fungsi yang sama.

Contoh#

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

// Create the V5 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);
}

Fungsi Keanggotaan#

Kelas timer mencakup fungsi anggota berikut:

  • clear — Mengatur ulang timer ke nol.

  • time — Mengembalikan waktu yang telah berlalu sejak timer dimulai.

  • event — Memanggil fungsi setelah sejumlah milidetik tertentu, dengan argumen opsional.

Sebelum memanggil fungsi anggota timer apa pun, sebuah instance brain harus dibuat, seperti yang ditunjukkan di bawah ini:

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

clear#

Mengatur ulang nilai timer saat ini ke nol. Setelah itu, timer segera mulai menghitung lagi dari nol.

Available Functions 
void clear();
Parameters

Fungsi ini tidak menerima parameter apa pun.

Return Values

Fungsi ini tidak mengembalikan nilai.

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

time#

Mengembalikan nilai timer saat ini.

Available Functions

1 — Mengembalikan waktu yang telah berlalu dalam milidetik.

uint32_t time() const;

2 — Mengembalikan waktu yang telah berlalu dalam satuan waktu yang ditentukan.

double time(
    timeUnits units ) const;
Parameters

Parameter

Jenis

Keterangan

units

timeUnits

Satuan yang digunakan untuk menampilkan waktu yang telah berlalu:

  • seconds / sec — detik
  • msec — milidetik
Return Values

  • Fungsi tanpa parameter (1) mengembalikan uint32_t yang mewakili waktu yang telah berlalu dalam milidetik.

  • Fungsi dengan parameter timeUnits (2) mengembalikan double yang mewakili waktu yang telah berlalu dalam satuan yang ditentukan.

Notes

  • Penghitung waktu mulai berjalan saat proyek dimulai.

  • Memanggil clear mengatur ulang nilai timer menjadi nol.

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#

Mendaftarkan fungsi callback yang akan dieksekusi setelah penundaan yang ditentukan.

Available Functions

1 — Mendaftarkan fungsi callback untuk dijalankan setelah penundaan yang ditentukan dan meneruskan nilai yang ditentukan pengguna ke fungsi callback tersebut.

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

2 — Mendaftarkan fungsi callback untuk dijalankan setelah penundaan yang ditentukan.

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

Parameter

Jenis

Keterangan

callback

void ()(void)

Sebuah fungsi yang akan dipanggil setelah penundaan yang ditentukan dan menerima argumen yang ditentukan pengguna.

callback

void (*)(void)

Sebuah fungsi yang akan dipanggil setelah penundaan yang ditentukan.

value

uint32_t

Penundaan, dalam milidetik, sebelum fungsi callback dieksekusi.
Return Values

Fungsi ini tidak mengembalikan nilai.

Notes

  • Fungsi ini menjadwalkan panggilan balik satu kali; fungsi ini tidak berulang secara otomatis.

  • Fungsi callback harus mengembalikan void.

  • Beberapa acara dapat dijadwalkan pada waktu yang bersamaan.

Examples

Definisikan fungsi (di luar int main())

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

Daftarkan fungsi di dalam int main()

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);
}
On this page