C++#

Esta guía proporciona información detallada sobre cómo utilizar las clases de C++ disponibles en VEXcode V5.

Cada dispositivo o sistema está representado como una clase de C++. Las páginas de clase incluyen información sobre:

  • Constructores – Cómo crear una instancia de la clase.

  • Funciones miembro – Las funciones que puede llamar en esa instancia.

  • Otros elementos de la API – Elementos adicionales como propiedades, secuencias de control o tipos relacionados, cuando corresponda.

Categorías de referencia de la API#

Explore la API de C++ por dispositivo, sistema o función de programación:

  • Transmisión – Controla una transmisión con o sin un sensor inercial, GPS o giroscópico conectado.

  • Motores y controladores de motor – Controla motores inteligentes y controladores de motor heredados.

  • Controlador – Entrada, salida, botones, joysticks e interacción con la pantalla del controlador V5.

  • Cerebro – Dibujo de la pantalla del cerebro V5 y recuperación de información del sistema.

  • Competition – Estructura de control de la competición, incluyendo cómo codificar los modos de control autónomo y del conductor.

  • Dispositivos de puerto inteligente – Dispositivos conectados a puertos inteligentes V5.

  • Dispositivos de 3 hilos – Dispositivos conectados a puertos de 3 hilos.

  • Console – Impresión de consola y formato de salida.

  • Lógica – Características de programación básicas como el flujo de control, variables, funciones, eventos, utilidades matemáticas, subprocesos y herramientas de temporización.

  • VEXlink – Comunicación entre múltiples cerebros V5 mediante enlace cableado o inalámbrico.

  • CTE Workcell – Clases y utilidades necesarias para controlar y configurar un sistema CTE Workcell.

Comprender las entradas de la API#

Cada entrada de la API está organizada para ayudarte a comprender rápidamente qué hace una función, un constructor o una propiedad y cómo usarla en tu código.

Dependiendo del tipo de elemento de la API, es posible que vea las siguientes secciones:

  • Descripción – Explica qué hace la función o el elemento y qué efecto tiene en tu código.

  • Funciones disponibles / Sintaxis: muestra la sintaxis exacta de C++ que debe utilizar. Si existen varias versiones, cada una se muestra por separado.

  • Parámetros – Describe las entradas que puede proporcionar, incluidos los valores válidos y las unidades.

  • Valores de retorno – Explica qué devuelve la función, si es que devuelve algo.

  • Notas – Resalta comportamientos importantes, limitaciones o interacciones con otras funciones.

  • Ejemplos – Proporciona código C++ comentado que demuestra cómo se utiliza habitualmente la función.

No todas las entradas incluyen todas las secciones. Las funciones más sencillas pueden incluir únicamente información sobre la sintaxis y el valor de retorno, mientras que las funciones más avanzadas pueden incluir notas detalladas y ejemplos complejos.

Todos los ejemplos de código están escritos para ser prácticos y realistas, de modo que puedas copiarlos y pegarlos en tus propios proyectos con mínimas modificaciones.

Ejemplo de entrada de API#

A continuación se muestra un ejemplo simplificado que ilustra cómo se estructura una entrada de función típica:

stop

Detiene la transmisión.

Available Functions

1 — Detiene el tren motriz utilizando el modo de parada configurado actualmente.

void stop();

2 — Detiene la transmisión utilizando el modo de frenado especificado.

void stop(
    brakeType mode );
Parameters

Parámetro

Tipo

Descripción

mode

brakeType

The brake type to use when stopping the drivetrain:

  • brake — Stops immediately.
  • coast — Slows gradually to a stop.
  • hold — Stops and resists movement using motor feedback.
Return Values

Esta función no devuelve ningún valor.

Examples 
// Drive forward, then coast to a stop
myDrivetrain.setDriveVelocity(100, percent);
myDrivetrain.drive(forward);
wait(2, seconds);
myDrivetrain.stop(coast);
En esta página