Python#

VEX IQ (2:a generationen) Python API-referens 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 IQ (2:a generationen) Python-projekt. Block och C+±projekt använder istället de andra API-sektionerna.

Obs: IQ (2:a generationen) Brain kör Python genom en virtuell maskin med begränsat minne. Även om det finns en maximal källkodsstorlek, beror huruvida ett program kommer att köras också på dess komplexitet (såsom antalet funktioner, variabler och logik som används). Som ett resultat kan program som är stora eller komplexa misslyckas med att kompilera eller köras även om de är under storleksgränsen. C/C+±program påverkas generellt sett mindre av dessa begränsningar för IQ (2:a generationen).

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 `REVERSE` i `drivetrain.drive(REVERSE, 20, PERCENT)`.

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.

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 120 rpm när `RPM`, eller från 0 till 720 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: `PERCENT` (standard), `RPM` (varv per minut) eller `VelocityUnits.DPS` (grader per sekund).

# Drive forward then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()