Python#

La referencia de la API de Python de VEX V5 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 V5. Los bloques y los proyectos de C++ utilizan las demás secciones de la API.

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 `360.0` in `drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)`.

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. For RPM or degrees per second, the limit is changed by the gear ratio of the drivetrain.

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 600 rpm when using `RPM`, or from 0 to 3600 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: `RPM` (rotations per minute, default), `PERCENT`, or `VelocityUnits.DPS` (degrees per second).

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

# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)