Python#

VEX AIM Python API Reference selittää, mitä kukin komento, metodi ja funktio tekee, mitä syötteitä ne käyttävät, mitä ne palauttavat ja miten niitä voidaan käyttää projektissa.

Käytä tätä viitettä, kun haluat ymmärtää komennon ennen sen lisäämistä projektiin, tarkistaa sen hyväksymät tai palauttamat arvot tai vertailla toisiinsa liittyviä komentoja kategoriassa.

Python-komentoja käytetään VEXcode AIM Python -projekteissa. Blocks-projektit käyttävät sen sijaan Blocks API -osiota.

Metodimerkinnän lukeminen#

Useimmat Python-merkinnät sisältävät seuraavat osat:

Komennon nimi - Komennon, metodin tai funktion virallinen nimi.
Kuvaus - Selittää, mitä komento tekee ja milloin siitä on hyötyä.
Käyttö - Näyttää komennon kirjoittamiseen käytetyn syntaksin koodissa.
Parametrit - Listaa komennon hyväksymät syötteet ja selittää, mitä kukin niistä tekee.
Paluuarvo - Selittää, mitä komento raportoi, jos se palauttaa arvon.
Esimerkkikoodi - Näyttää yhden tavan, jolla komentoa voidaan käyttää projektissa.

Yleisiä Python API -elementtejä#

Elementti	Mitä se tarkoittaa
Menetelmä	Komento, jota kutsutaan objektille, kuten `robot.move_at(…)`.
Toiminto	Suoraan kutsuttu komento, kuten `wait(…)` tai `print(…)`.
Parametri	Metodille tai funktiolle välitetty arvo, joka ohjaa sen toimintaa.
Valinnainen parametri	Parametri, joka voidaan jättää pois, jolloin käytetään oletustoimintoa.
Palautusarvo	Komennon raportoima arvo, kuten numero, teksti tai totuusarvo.

Pythonin perussanasto#

Termi	Mitä se tarkoittaa
Muuttuja	Nimi, joka tallentaa arvon, kuten `speed = 50`.
Merkkijono	Teksti lainausmerkkien sisällä, kuten `“Hello”`.
Kokonaisluku	Positiivinen tai negatiivinen luku, kuten `90`.
Kellua	Desimaaliluku, kuten `25.5`.
Totuusarvo	Arvo, joka on joko `True` tai `False`.
Argumentti	Metodiin tai funktion kutsuun välitetty arvo, kuten `0` in `robot.move_at(0)`.

Esimerkki menetelmän syötteestä#

move_at#

move_at liikuttaa robottia ikuisesti tietyssä kulmassa. Robotti jatkaa liikkumista, kunnes sille annetaan toinen toiminto, kuten liikkuminen eri kulmassa, kääntyminen tai pysähtyminen.

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

Parametrit	Kuvaus
`angle`	Robotin liikkumiskulma asteina. Tämä voi olla kokonaisluku tai desimaaliluku väliltä -360 - 360.
`velocity`	Valinnainen. Liikumisnopeus 0 %:sta 100 %:iin, kun käytetään arvoa `PERCENT`, tai 0:sta 200 millimetriin sekunnissa, kun käytetään arvoa `MMPS`Tämä voi olla kokonaisluku tai desimaaliluku. Jos nopeutta ei anneta, robotti liikkuu nykyisellä liikenopeudella.
`units`	Valinnainen. Nopeuden yksikkö: `PERCENT` (oletus) tai `MMPS` (millimetriä sekunnissa).

# Move forward
robot.move_at(0)