Python#

A Referência da API Python do VEX GO explica o que cada comando, método e função faz, que entradas utiliza, o que retorna e como pode ser utilizado num projeto.

Utilize esta referência quando pretende compreender um comando antes de o adicionar a um projeto, verificar que valores aceita ou devolve, ou comparar comandos relacionados numa categoria.

Os comandos Python são utilizados em projetos VEXcode GO Python. Os projetos em blocos utilizam a secção API de Blocos.

Como ler uma entrada de método#

A maioria das entradas em Python inclui as seguintes partes:

  • Nome do comando - O nome oficial do comando, método ou função.

  • Descrição - Explica o que o comando faz e quando é útil.

  • Utilização - Mostra a sintaxe utilizada para escrever o comando no código.

  • Parâmetros - Lista as entradas que o comando aceita e explica o que cada uma faz.

  • Valor de retorno - Explica o que o comando retorna, caso devolva algum valor.

  • Código de exemplo - Mostra uma forma de utilizar o comando num projeto.

Elementos comuns da API do Python#

Elemento

O que significa

Método

Um comando chamado num objeto como drivetrain.drive(…).

Função

Um comando chamado directamente, como por exemplo wait(…) ou print(…).

Parâmetro

Um valor passado para um método ou função para controlar o que faz.

Parâmetro opcional

Um parâmetro que pode ser omitido para que seja utilizado o comportamento padrão.

Valor de retorno

Um valor devolvido por um comando, como um número, texto ou valor booleano.

Vocabulário básico de Python#

Termo

O que significa

Variável

Um nome que armazena um valor, como por exemplo distance = 200.

Fio

Texto entre aspas, como “Hello”.

Número inteiro

Um número positivo ou negativo, como por exemplo 90.

Flutuar

Um número com decimais, como 25.5.

Booleano

Um valor que pode ser True ou False.

Discussão

Um valor passado para uma chamada de método ou função, como por exemplo FORWARD em drivetrain.drive(FORWARD).

Exemplo de entrada de método#

conduzir#

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)

Parâmetros

Descrição

direction

A direção em que o robô se move: FORWARD ou 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)