ตัวจับเวลาแบบกำหนดเอง

การแนะนำ

คลาส timer ใช้สำหรับรักษาเวลาและโต้ตอบกับตัวจับเวลาโดยอิสระจาก ตัวจับเวลาของสมอง

คอนสตรัคเตอร์คลาส

timer();

ตัวทำลายคลาส

ทำลายอ็อบเจ็กต์ timer และปล่อยทรัพยากรที่เกี่ยวข้อง

~timer();

พารามิเตอร์

คอนสตรัคเตอร์นี้ไม่รับพารามิเตอร์ใดๆ

ตัวอย่าง

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

ฟังก์ชันสมาชิก

คลาส timer ประกอบด้วยฟังก์ชันสมาชิกต่อไปนี้:

• clear — รีเซ็ตตัวจับเวลาเป็นศูนย์

• time — ส่งคืนเวลาที่ผ่านไปนับตั้งแต่ตัวจับเวลาเริ่มต้น

• event — เรียกฟังก์ชันหลังจากจำนวนมิลลิวินาทีที่ระบุ โดยมีอาร์กิวเมนต์เสริม

ก่อนเรียกใช้ฟังก์ชันสมาชิก timer ใดๆ จะต้องสร้างอินสแตนซ์ timer ก่อน ดังแสดงด้านล่าง:

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

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

clear

ตั้งค่าตัวจับเวลาเป็นศูนย์

Available Functions

void clear();

Parameters

ฟังก์ชันนี้ไม่รับพารามิเตอร์ใดๆ

Return Values

ฟังก์ชันนี้ไม่ส่งค่ากลับ

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

ส่งคืนค่าปัจจุบันของตัวจับเวลา

Available Functions

1 — ส่งคืนเวลาที่ผ่านไปในหน่วยมิลลิวินาที

uint32_t time() const;

2 — ส่งคืนเวลาที่ผ่านไปในหน่วยเวลาที่ระบุ

double time(
    timeUnits units ) const;

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
units	timeUnits	หน่วยที่ใช้ในการแสดงเวลาที่ผ่านไป: seconds sec วินาที msec มิลลิวินาที

Return Values

• ฟังก์ชันที่ไม่มีพารามิเตอร์ (1) จะส่งคืนค่า uint32_t ซึ่งแสดงถึงเวลาที่ผ่านไปในหน่วยมิลลิวินาที

• ฟังก์ชันที่มีพารามิเตอร์ timeUnits (2) จะส่งคืนค่า double ซึ่งแสดงถึงเวลาที่ผ่านไปในหน่วยที่ระบุ

Notes

• ตัวจับเวลาจะเริ่มนับเมื่อสร้างตัวจับเวลาแบบกำหนดเองเสร็จแล้ว

• การเรียก clear จะรีเซ็ตค่าตัวจับเวลาเป็นศูนย์

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

ลงทะเบียนฟังก์ชันเรียกกลับ (callback function) เพื่อให้ทำงานหลังจากระยะเวลาหน่วงที่กำหนดไว้

Available Functions

1 — ลงทะเบียนฟังก์ชันเรียกกลับ (callback) เพื่อให้ทำงานหลังจากหน่วงเวลาที่กำหนด และส่งค่าที่ผู้ใช้กำหนดไปยังฟังก์ชันเรียกกลับนั้น

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

2 — ลงทะเบียนฟังก์ชันเรียกกลับ (callback) เพื่อให้ทำงานหลังจากหน่วงเวลาที่กำหนด

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

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
callback	void (*)(void *)	ฟังก์ชันที่จะถูกเรียกใช้หลังจากระยะเวลาหน่วงที่ระบุไว้ และรับอาร์กิวเมนต์ที่ผู้ใช้กำหนด
callback	void (*)(void)	ฟังก์ชันที่จะถูกเรียกใช้หลังจากระยะเวลาหน่วงที่ระบุไว้
value	uint32_t	ระยะเวลาหน่วง (หน่วยเป็นมิลลิวินาที) ก่อนที่ฟังก์ชันเรียกกลับจะถูกเรียกใช้งาน

Return Values

ฟังก์ชันนี้ไม่ส่งค่ากลับ

Notes

• ฟังก์ชันนี้จะกำหนดเวลาเรียกกลับเพียงครั้งเดียวเท่านั้น และจะไม่เรียกซ้ำโดยอัตโนมัติ

• ฟังก์ชันเรียกกลับต้องส่งคืนค่า void

• อาจมีการจัดกิจกรรมหลายอย่างพร้อมกัน

Examples

กำหนดฟังก์ชัน (นอก int main())

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

ลงทะเบียนฟังก์ชันภายใน 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);
}