Python#

VEX EXP 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 EXP Python -projekteissa. Lohkot ja C+±projektit käyttävät muita API-osioita.

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 `drivetrain.drive(…)`.
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 funktiokutsuun välitetty arvo, kuten `FORWARD` kohdassa `drivetrain.drive(FORWARD)`.

Esimerkki menetelmän syötteestä#

ajaa#

drive liikuttaa robottia eteen- tai taaksepäin ikuisesti. Robotti jatkaa liikkumista, kunnes sille annetaan toinen toiminto, kuten kääntyminen tai pysähtyminen.

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

Parametrit	Kuvaus
`direction`	Robotin liikesuunta: `FORWARD` tai `REVERSE`.
`velocity`	Optional. The velocity to drive with from 0% to 100% when using `PERCENT`, from 0 to 120 rpm when using `RPM`, or from 0 to 720 degrees per second when using `VelocityUnits.DPS`. This can be an `integer` or decimal (`float`). If no velocity is provided, the robot drives at the current drive velocity.
`units`	Valinnainen. Nopeuden yksikkö: `PERCENT` (oletus), `RPM` (kierrosta minuutissa) tai `VelocityUnits.DPS` (astetta sekunnissa).

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