Python

VEX CTE 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 Python projektos. Blocks projektos tā vietā tiek izmantota Blocks API sadaļa.

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, arm.move_inc(…).
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, x_target = 120.
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, 100 in arm.move_inc(0, 100, 0).

Metodes ievades piemērs

move_inc

move_inc pārvieto 6 asu sviru par noteiktu attālumu pa x, y un z asīm.

Šī metode atgriezīs Būla vērtību, kas norāda, vai 6 asu roka ir sasniegusi pieprasīto pozīciju:

• True — 6 asu roka ir sasniegusi pieprasīto pozīciju.

• False — 6 asu roka nevar sasniegt pieprasīto pozīciju.

Usage:
arm.move_inc(x, y, z, wait)

Parametrs	Apraksts
x	Attālums, kas jāpārvietojas pa x asi milimetros.
y	Attālums milimetros, kas jāpārvietojas pa y asi.
z	Attālums, kas jāpārvietojas pa z asi milimetros.
wait	Neobligāti. wait=True (noklusējums) — projekts gaida, līdz move_inc ir pabeigts, pirms tiek izpildīta nākamā koda rinda. wait=False — projekts sāk darbību un nekavējoties pāriet uz nākamo koda rindu, negaidot, kamēr move_inc ir pabeigts.

# Move the Arm +100 millimeters on the y-axis
arm.move_inc(0, 100, 0)