Προσαρμοσμένος χρονοδιακόπτης#

Εισαγωγή#

Η κλάση 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#

Καταγράφει μια συνάρτηση επανάκλησης που θα εκτελεστεί μετά από μια καθορισμένη καθυστέρηση.

Available Functions

1 — Καταχωρεί μια επανάκληση για εκτέλεση μετά από μια καθορισμένη καθυστέρηση και μεταβιβάζει μια τιμή που ορίζεται από τον χρήστη στην επανάκληση.

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

2 — Καταχωρεί μια επανάκληση για εκτέλεση μετά από μια καθορισμένη καθυστέρηση.

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