Python#

„VEX IQ“ (2-osios kartos) „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 IQ“ (2-osios kartos) „Python“ projektuose. Blokų ir C++ projektuose vietoj jų naudojamos kitos API dalys.

Pastaba: IQ (2-osios kartos) smegenys vykdo Python per virtualią mašiną su ribota atmintimi. Nors yra maksimalus šaltinio kodo dydis, tai, ar programa veiks, taip pat priklauso nuo jos sudėtingumo (pvz., funkcijų, kintamųjų skaičiaus ir naudojamos logikos). Dėl to didelės ar sudėtingos programos gali nepavykti kompiliuoti arba paleisti, net jei jos neviršija dydžio ribos. C/C++ programoms šie IQ (2-osios kartos) apribojimai paprastai daro mažesnę įtaką.

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. `REVERSE` iš `drivetrain.drive(REVERSE, 20, PERCENT)`.

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