Python#

A VEX IQ (2. generációs) Python API referencia elmagyarázza, hogy mit csinálnak az egyes parancsok, metódusok és függvények, milyen bemeneteket használnak, mit adnak vissza, és hogyan használhatók egy projektben.

Ezt a referenciát akkor használd, ha egy parancsot meg szeretnél érteni, mielőtt hozzáadnád egy projekthez, ellenőrizni szeretnéd, hogy milyen értékeket fogad el vagy ad vissza, vagy összehasonlítani szeretnéd a kapcsolódó parancsokat egy kategóriában.

A VEXcode IQ (2. generációs) Python projektekben Python parancsokat használnak. A blokkok és a C++ projektek ehelyett a többi API szakaszt használják.

Megjegyzés: Az IQ (2. generációs) agy korlátozott memóriával rendelkező virtuális gépen futtatja a Pythont. Bár van maximális forráskódméret, egy program futása a bonyolultságától is függ (például a használt függvények, változók és logika számától). Ennek eredményeként a nagy vagy összetett programok lefordulása vagy futtatása sikertelen lehet, még akkor is, ha a méretkorlát alatt vannak. A C/C++ programokat általában kevésbé érintik ezek az IQ (2. generáció) korlátai.

Hogyan olvassunk el egy metódusbejegyzést#

A legtöbb Python bejegyzés a következő részeket tartalmazza:

Parancs neve – A parancs, metódus vagy függvény hivatalos neve.
Leírás – Elmagyarázza, hogy mit csinál a parancs, és mikor hasznos.
Használat – Megjeleníti a parancs kódban való írásához használt szintaxist.
Paraméterek – Felsorolja a parancs által elfogadott bemeneteket, és elmagyarázza, hogy mit csinálnak.
Visszatérési érték – Elmagyarázza, hogy mit jelent vissza a parancs, ha értéket ad vissza.
Példakód – Bemutat egy módot, ahogyan a parancs használható egy projektben.

Gyakori Python API elemek#

Elem	Mit jelent
Módszer	Egy parancs meghívása egy objektumon, például `drivetrain.drive(…)`.
Funkció	Egy közvetlenül meghívott parancs, például `wait(…)` vagy `print(…)`.
Paraméter	Egy metódusnak vagy függvénynek átadott érték, amely a műveletét szabályozza.
Választható paraméter	Egy paraméter, amelyet ki lehet hagyni, így az alapértelmezett viselkedés lesz érvényben.
Visszatérési érték	Egy parancs által visszaadott érték, például szám, szöveg vagy logikai érték.

Alapvető Python szókincs#

Kifejezés	Mit jelent
Változó	Egy olyan név, amely értéket tárol, például `speed = 50`.
Húr	Idézőjelek között lévő szöveg, például `“Hello”`.
Egész szám	Pozitív vagy negatív szám, például `90`.
Úszó	Tizedesjegyet tartalmazó szám, például `25.5`.
Logikai	Egy olyan érték, amely vagy `True` , vagy `False`.
Érv	Egy metódus- vagy függvényhívásnak átadott érték, például `REVERSE` a `drivetrain.drive(REVERSE, 20, PERCENT)`.

Példa metódusbevitelre#

hajtás#

drive A robotot a végtelenségig előre vagy hátra mozgatja. A robot addig fog mozogni, amíg egy másik műveletet nem kap, például fordulást vagy megállást.

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

Paraméterek	Leírás
`direction`	A robot mozgásiránya: `FORWARD` vagy `REVERSE`.
`velocity`	Opcionális. A robot által vezérelt sebesség 0%-tól 100%-ig `PERCENT`használata esetén, 0-tól 120 rpm-ig `RPM`használata esetén, vagy 0-tól 720 fok/másodpercig `VelocityUnits.DPS`használata esetén. Ez lehet egy `integer` vagy decimális szám (`float`). Ha nincs megadva sebesség, a robot az aktuális sebességgel halad.
`units`	Opcionális. A sebesség mértékegysége: `PERCENT` (alapértelmezett), `RPM` (fordulat/perc) vagy `VelocityUnits.DPS` (fok/másodperc).

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