Python#

La Referencia de API de VEX GO Python 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 VEXcode GO Python. Los proyectos de Blocks utilizan la sección API de Blocks en su lugar.

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 distance = 200.

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 FORWARD en drivetrain.drive(FORWARD).

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.

Uso:
drivetrain.drive(direction)

Parámetros

Descripción

direction

La dirección en la que se mueve el robot: FORWARD O HACIA REVERSE.

# Build Used: Code Base 2.0
def main():
    # Drive forward then stop
    drivetrain.drive(FORWARD)
    wait(2, SECONDS)
    drivetrain.stop()

# Start threads - Do not delete
start_thread(main)