Python#

De VEX CTE Python API-referentie legt uit wat elk commando, elke methode en elke functie doet, welke invoerwaarden het gebruikt, wat het retourneert en hoe het in een project kan worden gebruikt.

Gebruik deze referentie wanneer u een commando wilt begrijpen voordat u het aan een project toevoegt, wilt controleren welke waarden het accepteert of retourneert, of verwante commando’s in een categorie wilt vergelijken.

In VEXcode Python-projecten worden Python-opdrachten gebruikt. Blocks-projecten gebruiken in plaats daarvan de Blocks API-sectie.

Hoe lees je een methode-invoer?#

De meeste Python-inzendingen bevatten de volgende onderdelen:

Opdrachtnaam - De officiële naam van de opdracht, methode of functie.
Beschrijving - Legt uit wat het commando doet en wanneer het nuttig is.
Gebruik - Toont de syntaxis die gebruikt wordt om de opdracht in code te schrijven.
Parameters - Hier worden de invoerwaarden van het commando weergegeven en wordt uitgelegd wat elke waarde doet.
Retourwaarde - Legt uit wat de opdracht teruggeeft, indien deze een waarde retourneert.
Voorbeeldcode - Laat zien hoe de opdracht in een project gebruikt kan worden.

Veelgebruikte Python API-elementen#

Element	Wat het betekent
Methode	Een commando dat wordt aangeroepen op een object, zoals `arm.move_inc(…)`.
Functie	Een direct aangeroepen commando, zoals `wait(…)` of `print(…)`.
Parameter	Een waarde die aan een methode of functie wordt doorgegeven om te bepalen wat deze doet.
Optionele parameter	Een parameter die weggelaten kan worden, zodat het standaardgedrag gebruikt wordt.
Retourwaarde	Een waarde die een commando teruggeeft, zoals een getal, tekst of Booleaanse waarde.

Basiswoordenschat van Python#

Termijn	Wat het betekent
Variabele	Een naam die een waarde opslaat, zoals `x_target = 120`.
Snaar	Tekst tussen aanhalingstekens, zoals `“Hello”`.
Geheel getal	Een positief of negatief getal, zoals `90`.
Vlot	Een getal met een decimaal, zoals `25.5`.
Booleaanse waarde	Een waarde die ofwel `True` of `False` is.
Argument	Een waarde die wordt doorgegeven aan een methode- of functieaanroep, zoals `100` in `arm.move_inc(0, 100, 0)`.

Voorbeeld van methode-invoer#

move_inc#

move_inc verplaatst de 6-assige arm over een opgegeven afstand langs de x-, y- en z-assen.

Deze methode retourneert een Booleaanse waarde die aangeeft of de 6-assige arm de gewenste positie heeft bereikt.

True - De 6-assige arm heeft de gevraagde positie bereikt.
False - De 6-assige arm kan de gevraagde positie niet bereiken.

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

Parameter	Beschrijving
X	De afstand die langs de x-as moet worden afgelegd in millimeters.
y	De afstand die langs de y-as moet worden afgelegd, in millimeters.
z	De afstand die langs de z-as moet worden afgelegd, in millimeters.
`wait`	Optioneel. `wait=True` (standaard) - Het project wacht tot `move_inc` is voltooid voordat de volgende regel code wordt uitgevoerd. `wait=False` - Het project start de actie en gaat direct verder met de volgende regel code, zonder te wachten tot `move_inc` is voltooid.

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