Python#

VEX V5 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 V5 Python-projekt. Block och C+±projekt använder istället de andra API-sektionerna.

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

Exempel på metodinmatning#

köra#

drive rör roboten framåt eller bakåt för alltid. Roboten fortsätter att röra sig tills den får en annan åtgärd, som att vända eller stanna. För varvtal eller grader per sekund ändras gränsen av drivlinans utväxling.

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

Parametrar	Beskrivning
`direction`	Robotens rörelseriktning: `FORWARD` eller `REVERSE`.
`velocity`	Valfritt. Hastigheten att köra med är från 0 % till 100 % när `PERCENT`, från 0 till 600 rpm när `RPM`, eller från 0 till 3600 grader per sekund när `VelocityUnits.DPS`används. Detta kan vara ett heltal `integer` eller ett decimaltal (`float`). Om ingen hastighet anges kör roboten med den aktuella körhastigheten.
`units`	Valfritt. Hastighetsenheten: `RPM` (varv per minut, standard), `PERCENT`eller `VelocityUnits.DPS` (grader per sekund).

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