Python#

VEX EXP Python API atsauce paskaidro, ko dara katra komanda, metode un funkcija, kādus ievades datus tā izmanto, ko atgriež un kā to var izmantot projektā.

Izmantojiet šo atsauci, ja vēlaties izprast komandu pirms tās pievienošanas projektam, pārbaudīt, kādas vērtības tā pieņem vai atgriež, vai salīdzināt saistītas komandas kategorijā.

Python komandas tiek izmantotas VEXcode EXP Python projektos. Bloku un C++ projektos tiek izmantotas citas API sadaļas.

Kā lasīt metodes ierakstu#

Lielākā daļa Python ierakstu ietver šādas daļas:

Komandas nosaukums — komandas, metodes vai funkcijas oficiālais nosaukums.
Apraksts — Paskaidro, ko komanda dara un kad tā ir noderīga.
Lietojums — Parāda sintaksi, kas izmantota komandas rakstīšanai kodā.
Parametri — Uzskaita ievades datus, ko komanda pieņem, un paskaidro, ko katrs no tiem dara.
Atgrieztā vērtība — Paskaidro, ko komanda ziņo, ja tā atgriež vērtību.
Koda piemērs — parāda vienu veidu, kā komandu var izmantot projektā.

Bieži sastopamie Python API elementi#

Elements	Ko tas nozīmē
Metode	Komanda, kas izsaukta objektam, piemēram, `drivetrain.drive(…)`.
Funkcija	Tieši izsaukta komanda, piemēram `wait(…)` vai `print(…)`.
Parametrs	Vērtība, kas nodota metodei vai funkcijai, lai kontrolētu tās darbību.
Neobligāts parametrs	Parametrs, ko var izlaist, lai tiktu izmantota noklusējuma darbība.
Atgriešanas vērtība	Vērtība, ko komanda ziņo atpakaļ, piemēram, skaitlis, teksts vai Būla vērtība.

Python pamata vārdu krājums#

Termiņš	Ko tas nozīmē
Mainīgais	Nosaukums, kurā tiek glabāta vērtība, piemēram, `speed = 50`.
Virkne	Teksts pēdiņās, piemēram `“Hello”`.
Vesels skaitlis	Pozitīvs vai negatīvs skaitlis, piemēram `90`.
Peldošs	Skaitlis ar decimālzīmi, piemēram, `25.5`.
Būla	Vērtība, kas ir vai nu `True` , vai `False`.
Arguments	Vērtība, kas nodota metodes vai funkcijas izsaukumam, piemēram, `FORWARD` in `drivetrain.drive(FORWARD)`.

Metodes ievades piemērs#

braukt#

drive pārvieto robotu uz priekšu vai atpakaļ bezgalīgi. Robots turpinās kustēties, līdz tam tiks dota cita darbība, piemēram, pagriešana vai apstāšanās.

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

Parametri	Apraksts
`direction`	Robota kustības virziens: `FORWARD` vai `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`	Neobligāti. Ātruma mērvienība: `PERCENT` (pēc noklusējuma), `RPM` (apgriezieni minūtē) vai `VelocityUnits.DPS` (grādi 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()