ตัวจับเวลา#

การแนะนำ#

คลาส timer ได้รับมาจากคลาสพื้นฐาน brain และมีฟังก์ชันสำหรับการวัดเวลาที่ผ่านไป ช่วยให้คุณสามารถติดตามระยะเวลาและกำหนดตารางเหตุการณ์ตามเวลาภายในโปรแกรม VEX V5 ได้

เข้าถึง#

Brain.Timer

หมายเหตุ#

  • Brain.Timer เป็นอินสแตนซ์ของคลาส timer และให้ฟังก์ชันการทำงานเดียวกัน

ตัวอย่าง#

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

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

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

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

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

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

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

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

clear#

รีเซ็ตค่าปัจจุบันของตัวจับเวลาเป็นศูนย์ จากนั้นตัวจับเวลาจะเริ่มนับขึ้นใหม่จากศูนย์ทันที

Available Functions
void clear();

Parameters

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

Return Values

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

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#

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

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

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

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