Timer#

Introducción #

The timer class is used to keep time and interact with a timer independent of the Brain’s timer.

Constructor de clases #

timer();

Instructor de clase #

Destroys the timer object and releases associated resources.

~timer();

Parámetros #

Este constructor no acepta ningún parámetro.

Ejemplos #

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

Funciones de los miembros #

The timer class includes the following member functions:

reset — Resets the timer to zero.
value — 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 timer instance must be created, as shown below:

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

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

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

// Create the Brain to use Brain.Timer
brain Brain = brain();

reset #

Pon el temporizador a cero.

Available Functions

void reset();

Parameters

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

Return Values

Esta función no devuelve ningún valor.

Examples

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

value #

Devuelve el valor actual del temporizador.

Available Functions

double value();

Parameters

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

Return Values

A double representing the amount of time passed in seconds.

Notes

The timer begins counting when the timer is constructed.
Calling reset 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", myTimer.value());

  wait(50, msec);
}

event #

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

Define the function (outside of int main())

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

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