Minutero

Introducción

The timer class is derived from the brain base class and provides functionality for measuring elapsed time, allowing you to track durations and schedule time-based events within a VEX EXP program.

Acceso

Brain.Timer

Notas

• Brain.Timer is an instance of the timer class and provides the same functionality.

Ejemplo

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

Funciones de los miembros

The timer class includes the following member functions:

• clear — Resets the timer to zero.

• time — Returns the elapsed time since the timer started.

• event — Calls a function after a specified number of milliseconds, with optional arguments.

Before calling any timer member functions, a brain instance must be created, as shown below:

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

claro

Reinicia el valor actual del temporizador a cero. A continuación, el temporizador comienza a contar de nuevo desde cero inmediatamente.

Available Functions

void clear();

Parameters

Esta función no acepta ningún parámetro.

Return Values

Esta función no devuelve ningún valor.

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

tiempo

Devuelve el valor actual del temporizador.

Available Functions

1 — Devuelve el tiempo transcurrido en milisegundos.

uint32_t time() const;

2 — Devuelve el tiempo transcurrido en las unidades de tiempo especificadas.

double time(
    timeUnits units ) const;

Parameters

Parámetro	Tipo	Descripción
units	timeUnits	The units used to return the elapsed time: seconds / sec — seconds msec — milliseconds

Return Values

• The parameterless function (1) returns a uint32_t representing the elapsed time in milliseconds.

• The function with a timeUnits parameter (2) returns a double representing the elapsed time in the specified units.

Notes

• El temporizador comienza a contar cuando se inicia el proyecto.

• Calling clear resets the timer value to zero.

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

evento

Registra una función de devolución de llamada que se ejecutará después de un retraso especificado.

Available Functions

1 — Registra una función de devolución de llamada para que se ejecute después de un retraso especificado y pasa un valor definido por el usuario a la función de devolución de llamada.

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

2 — Registra una función de devolución de llamada para que se ejecute después de un retraso especificado.

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

Parameters

Parámetro	Tipo	Descripción
callback	void ()(void)	Una función que se llamará después del retraso especificado y que recibe un argumento definido por el usuario.
callback	void (*)(void)	Una función que se llamará después del retraso especificado.
value	uint32_t	El retraso, en milisegundos, antes de que se ejecute la función de devolución de llamada.

Return Values

Esta función no devuelve ningún valor.

Notes

• Esta función programa una llamada de retorno única; no se repite automáticamente.

• The callback function must return void.

• Se pueden programar varios eventos al mismo tiempo.

Examples

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

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