Python#

VEX AIM Python API-referensen förklarar vad varje kommando, metod och funktion gör, vilka indata den använder, vad den returnerar och hur den kan användas i ett projekt.

Använd den här referensen när du vill förstå ett kommando innan du lägger till det i ett projekt, kontrollera vilka värden det accepterar eller returnerar, eller jämföra relaterade kommandon i en kategori.

Python-kommandon används i VEXcode AIM Python-projekt. Blocks-projekt använder istället Blocks API-sektionen.

Hur man läser en metodpost#

De flesta Python-poster innehåller följande delar:

  • Kommandonamn - Det officiella namnet på kommandot, metoden eller funktionen.

  • Beskrivning - Förklarar vad kommandot gör och när det är användbart.

  • Användning - Visar syntaxen som används för att skriva kommandot i kod.

  • Parametrar - Listar de indata som kommandot accepterar och förklarar vad var och en gör.

  • Returvärde - Förklarar vad kommandot rapporterar tillbaka om det returnerar ett värde.

  • Exempelkod - Visar ett sätt som kommandot kan användas i ett projekt.

Vanliga Python API-element#

Element

Vad det betyder

Metod

Ett kommando som anropas på ett objekt som robot.move_at(…).

Fungera

Ett kommando som anropas direkt, såsom wait(…) eller print(…).

Parameter

Ett värde som matas in i en metod eller funktion för att styra vad den gör.

Valfri parameter

En parameter som kan utelämnas så att standardbeteendet används.

Returvärde

Ett värde som ett kommando rapporterar tillbaka, till exempel ett tal, en text eller ett booleskt värde.

Grundläggande Python-vokabulär#

Kalla

Vad det betyder

Variabel

Ett namn som lagrar ett värde, till exempel speed = 50.

Sträng

Text inom citattecken, till exempel “Hello”.

Heltal

Ett positivt eller negativt tal, till exempel 90

Flyta

Ett tal med ett decimaltal, till exempel 25.5.

Boolesk

Ett värde som antingen är True eller False.

Argument

Ett värde som matas in i ett metod- eller funktionsanrop, till exempel 0 i robot.move_at(0).

Exempel på metodinmatning#

move_at#

move_at flyttar roboten för alltid i en specifik vinkel. Roboten fortsätter att röra sig tills den får en annan åtgärd, som att röra sig i en annan vinkel, vända eller stanna.

Usage:
robot.move_at(angle, velocity, units)

Parametrar

Beskrivning

angle

Vinkeln, i grader, som roboten rör sig. Detta kan vara ett heltal eller ett decimaltal från -360 till 360.

velocity

Valfritt. Hastigheten att röra sig med från 0 % till 100 % när PERCENT, eller från 0 till 200 millimeter per sekund när MMPSanvänds . Detta kan vara ett heltal eller ett decimaltal. Om ingen hastighet anges rör sig roboten med den aktuella rörelsehastigheten.

units

Valfritt. Hastighetsenheten: PERCENT (standard) eller MMPS (millimeter per sekund).

# Move forward
robot.move_at(0)