Python#

La referencia de la API de Python de VEX IQ (2.ª generación) explica qué hace cada comando, método y función, qué entradas utiliza, qué devuelve y cómo se puede utilizar 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 los proyectos de Python de VEXcode IQ (segunda generación). Los bloques y los proyectos de C++ utilizan las demás secciones de la API.

Nota: El procesador IQ (2.ª generación) ejecuta Python en una máquina virtual con memoria limitada. Si bien existe un tamaño máximo para el código fuente, la ejecución de un programa también depende de su complejidad (como la cantidad de funciones, variables y lógica utilizadas). Por lo tanto, los programas grandes o complejos pueden fallar al compilarse o ejecutarse, incluso si no superan el límite de tamaño. Los programas en C/C++ generalmente se ven menos afectados por estas limitaciones en IQ (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.
Valor de retorno - Explica qué valor devuelve el comando, si es que devuelve alguno.
Código de ejemplo - Muestra una forma en que se puede utilizar el comando en un proyecto.

Elementos comunes de la API de Python#

Elemento	Qué significa
Método	A command called on an object such as `drivetrain.drive(…)`.
Función	A command called directly, such as `wait(…)` or `print(…)`.
Parámetro	Un valor que se pasa 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 devuelve un comando, como un número, un texto o un valor booleano.

Vocabulario básico de Python#

Término	Qué significa
Variable	A name that stores a value, such as `speed = 50`.
Cadena	Text inside quotes, such as `“Hello”`.
Entero	A positive or negative number, such as `90`.
Flotar	A number with a decimal, such as `25.5`.
Booleano	A value that is either `True` or `False`.
Argumento	A value passed into a method or function call, such as `REVERSE` in `drivetrain.drive(REVERSE, 20, PERCENT)`.

Ejemplo de entrada de método#

conducir#

drive moves the robot forward or reverse forever. The robot will continue to move until it is given another action, like turning or stopping.

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

Parámetros	Descripción
`direction`	The direction the robot moves: `FORWARD` or `REVERSE`.
`velocity`	Optional. The velocity to drive with from 0% to 100% when using `PERCENT`, from 0 to 120 rpm when using `RPM`, or from 0 to 720 degrees per second when using `VelocityUnits.DPS`. This can be an `integer` or decimal (`float`). If no velocity is provided, the robot drives at the current drive velocity.
`units`	Optional. The velocity unit: `PERCENT` (default), `RPM` (rotations per minute), or `VelocityUnits.DPS` (degrees per second).

# 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()