Python#

A VEX CTE 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 Python projektekben Python parancsokat használnak. A Blocks projektek helyett a Blocks API részt használják.

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 objektumon meghívott parancs, például `arm.move_inc(…)`.
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 `x_target = 120`.
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 `100` in `arm.move_inc(0, 100, 0)`.

Példa metódusbevitelre#

move_inc#

move_inc A 6 tengelyes kart egy megadott távolsággal mozgatja az x, y és z tengelyek mentén.

Ez a metódus egy logikai értéket ad vissza, amely jelzi, hogy a 6 tengelyes kar elérte-e a kért pozíciót:

True - A 6 tengelyes kar elérte a kért pozíciót.
False - A 6 tengelyes kar nem éri el a kért pozíciót.

Usage:
arm.move_inc(x, y, z, wait)

Paraméter	Leírás
x	Az x tengely mentén elmozdítandó távolság milliméterben.
y	Az y tengely mentén elmozdítandó távolság milliméterben.
z	A z tengely mentén elmozdítandó távolság milliméterben.
`wait`	Opcionális. `wait=True` (alapértelmezett) - A projekt megvárja, amíg `move_inc` befejeződik, mielőtt végrehajtaná a következő kódsort. `wait=False` - A projekt elindítja a műveletet, és azonnal a következő kódsorra lép, anélkül, hogy megvárná `move_inc` befejezését.

# Move the Arm +100 millimeters on the y-axis
arm.move_inc(0, 100, 0)