Python#

La Referencia de API de Python de VEX IQ (2ª generación) explica qué hace cada comando, método y función, qué entradas usa, qué devuelve y cómo se puede usar en un proyecto.

Utilice esta referencia cuando desee comprender un comando antes de agregarlo a un proyecto, comprobar qué valores acepta o devuelve, o comparar comandos relacionados en una categoría.

Los comandos de Python se utilizan en proyectos de Python VEXcode IQ (2ª generación). Los bloques y los proyectos de C++ utilizan las otras secciones de la API en su lugar.

Nota: El Cerebro IQ (2ª generación) ejecuta Python a través de una máquina virtual con memoria limitada. Si bien hay un tamaño máximo de código fuente, si un programa se ejecutará también depende de su complejidad (como el número de funciones, variables y lógica utilizada). Como resultado, los programas que son grandes o complejos pueden no compilarse o ejecutarse incluso si están por debajo del límite de tamaño. Los programas C/C++ generalmente se ven menos afectados por estos límites en el coeficiente intelectual (2ª generación).

Cómo leer una entrada de método#

La mayoría de las entradas de Python incluyen las siguientes partes:

Nombre del comando - El nombre oficial del comando, método o función.
Descripción: explica qué hace el comando y cuándo es útil.
Uso - Muestra la sintaxis utilizada para escribir el comando en código.
Parámetros: enumera las entradas que acepta el comando y explica qué hace cada una.
Devolver valor: explica qué informa el comando, si devuelve un valor.
Código de ejemplo: muestra una forma en que se puede usar el comando en un proyecto.

Elementos comunes de la API de Python#

Elemento	Qué significa
Método	Un comando llamado a un objeto como `drivetrain.drive(…)`.
Función	Un comando llamado directamente, como `wait(…)` o `print(…)`.
Parámetro	Un valor pasado a un método o función para controlar lo que hace.
Parámetro opcional	Un parámetro que se puede omitir para que se utilice el comportamiento predeterminado.
Valor de retorno	Un valor que reporta un comando, como un número, texto o booleano.

Vocabulario básico de Python#

Plazo	Qué significa
Variable	Un nombre que almacena un valor, como `speed = 50`.
Cadena	Texto entre comillas, como `“Hello”`.
Entero	Un número positivo o negativo, como `90`.
Flotar	Un número con un decimal, como `25.5`.
Booleano	Un valor que es `True` o `False`.
Argumento	Un valor pasado a una llamada de método o función, como `REVERSE` en `drivetrain.drive(REVERSE, 20, PERCENT)`.

Ejemplo de entrada de método#

unidad#

drive mueve el robot hacia adelante o hacia atrás para siempre. El robot continuará moviéndose hasta que se le dé otra acción, como girar o detenerse.

Usage:
drivetrain.drive(direction, velocity, units)

Parámetros	Descripción
`direction`	La dirección en la que se mueve el robot: `FORWARD` O HACIA `REVERSE`.
`velocity`	Opcional. La velocidad para conducir con de 0% a 100% cuando se usa `PERCENT`, de 0 a 120 rpm cuando se usa `RPM`, o de 0 a 720 grados por segundo cuando se usa `VelocityUnits.DPS`. Esto puede ser un `integer` o decimal (`float`). Si no se proporciona velocidad, el robot se acciona a la velocidad de accionamiento actual.
`units`	Opcional. La unidad de velocidad: `PERCENT` (predeterminado), `RPM` (rotaciones por minuto) o `VelocityUnits.DPS` (grados por segundo).

# Drive forward then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()