Python#

A Referência da API Python do VEX V5 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 Python do VEXcode V5. Os projetos em blocos e C++ utilizam as outras secções da API.

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 `speed = 50`.
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 `360.0` em `drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)`.

Exemplo de entrada de método#

conduzir#

A entrada drive com que o robô se mova para a frente ou para trás indefinidamente. O robô continuará a mover-se até receber outra ação, como virar-se ou parar. Para RPM ou graus por segundo, o limite é alterado pela relação de transmissão do sistema de acionamento.

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

Parâmetros	Descrição
`direction`	A direção em que o robô se move: `FORWARD` ou `REVERSE`.
`velocity`	Opcional. A velocidade de accionamento varia de 0% a 100% quando se utiliza `PERCENT`, de 0 a 600 rpm quando se utiliza `RPM`ou de 0 a 3600 graus por segundo quando se utiliza `VelocityUnits.DPS`Pode ser um número inteiro `integer` float`float`. Se não for fornecida qualquer velocidade, o robô move-se à velocidade de acionamento atual.
`units`	Opcional. A unidade de velocidade: `RPM` (rotações por minuto, padrão), `PERCENT`ou `VelocityUnits.DPS` (graus por segundo).

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