Python#

„VEX EXP Python API“ nuorodoje paaiškinama, ką daro kiekviena komanda, metodas ir funkcija, kokias įvestis jie naudoja, ką grąžina ir kaip juos galima naudoti projekte.

Šią nuorodą naudokite, kai norite suprasti komandą prieš ją įtraukdami į projektą, patikrinti, kokias reikšmes ji priima arba grąžina, arba palyginti susijusias komandas kategorijoje.

Python komandos naudojamos VEXcode EXP Python projektuose. Blokų ir C++ projektuose vietoj jų naudojamos kitos API dalys.

Kaip skaityti metodo įrašą#

Daugumą „Python“ įrašų sudaro šios dalys:

Komandos pavadinimas – oficialus komandos, metodo arba funkcijos pavadinimas.
Aprašymas – Paaiškina, ką komanda daro ir kada ji naudinga.
Naudojimas – rodo sintaksę, naudojamą komandai rašyti kode.
Parametrai – Pateikia komandos priimamų įvesčių sąrašą ir paaiškina kiekvienos iš jų funkciją.
Grąžina reikšmę – Paaiškina, ką komanda praneša, jei grąžina reikšmę.
Pavyzdinis kodas – parodo vieną iš būdų, kaip komanda gali būti naudojama projekte.

Įprasti Python API elementai#

Elementas	Ką tai reiškia
Metodas	Komanda, iškviesta objektui, pvz., `drivetrain.drive(…)`.
Funkcija	Tiesiogiai iškviečiama komanda, pvz. `wait(…)` arba `print(…)`.
Parametras	Reikšmė, perduodama metodui arba funkcijai, siekiant valdyti jo veiksmus.
Pasirinktinis parametras	Parametras, kurio galima praleisti, kad būtų naudojamas numatytasis veikimas.
Grąžinimo vertė	Komandos pateikiama reikšmė, pvz., skaičius, tekstas arba loginė reikšmė.

Pagrindinis Python žodynas#

Terminas	Ką tai reiškia
Kintamasis	Pavadinimas, kuriame saugoma reikšmė, pvz., `speed = 50`.
Eilutė	Tekstas kabutėse, pvz., `“Hello”`.
Sveikasis skaičius	Teigiamas arba neigiamas skaičius, pvz. `90`.
Plūduriuojantis	Skaičius su dešimtainiu tikslumu, pvz., `25.5`.
Būlio	Reikšmė, kuri yra `True` arba `False`.
Argumentas	Reikšmė, perduota metodo arba funkcijos iškvietimui, pvz. `FORWARD` iš `drivetrain.drive(FORWARD)`.

Metodo įvedimo pavyzdys#

vairuoti#

drive robotą judina pirmyn arba atgal amžinai. Robotas judės tol, kol jam bus duotas kitas veiksmas, pvz., pasisukti arba sustoti.

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

Parametrai	Aprašymas
`direction`	Roboto judėjimo kryptis: `FORWARD` arba `REVERSE`.
`velocity`	Pasirinktinai. Važiavimo greitis nuo 0 % iki 100 %, kai naudojama `PERCENT`, nuo 0 iki 120 aps./min., kai naudojama `RPM`, arba nuo 0 iki 720 laipsnių per sekundę, kai naudojama `VelocityUnits.DPS`Tai gali būti sveikasis skaičius `integer` arba dešimtainis skaičius (`float`). Jei greitis nenurodytas, robotas važiuoja dabartiniu važiavimo greičiu.
`units`	Pasirinktinai. Greičio vienetas: `PERCENT` (numatytasis), `RPM` (apsisukimai per minutę) arba `VelocityUnits.DPS` (laipsniai 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()