Python#

De VEX IQ (2e generatie) Python API-referentie legt uit wat elk commando, elke methode en elke functie doet, welke invoer 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 IQ (2e generatie) Python-projecten worden Python-commando’s gebruikt. Blocks- en C+±projecten gebruiken in plaats daarvan de andere API-secties.

Let op: De IQ (2e generatie) Brain voert Python uit via een virtuele machine met beperkt geheugen. Hoewel er een maximale broncodegrootte is, hangt het al dan niet uitvoeren van een programma ook af van de complexiteit ervan (zoals het aantal functies, variabelen en gebruikte logica). Hierdoor kunnen grote of complexe programma’s mogelijk niet compileren of uitvoeren, zelfs als ze binnen de maximale grootte vallen. C/C+±programma’s worden over het algemeen minder beïnvloed door deze beperkingen op de IQ (2e generatie).

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 `drivetrain.drive(…)`.
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 `speed = 50`.
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 `REVERSE` in `drivetrain.drive(REVERSE, 20, PERCENT)`.

Voorbeeld van methode-invoer#

drijfveer#

drive de robot beweegt oneindig vooruit of achteruit. De robot blijft bewegen totdat er een andere actie wordt gegeven, zoals draaien of stoppen.

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

Parameters	Beschrijving
`direction`	De richting waarin de robot beweegt: `FORWARD` of `REVERSE`.
`velocity`	Optioneel. De snelheid waarmee gereden moet worden, van 0% tot 100% bij gebruik van `PERCENT`, van 0 tot 120 rpm bij gebruik van `RPM`, of van 0 tot 720 graden per seconde bij gebruik van `VelocityUnits.DPS`Dit kan een `integer` of een decimaal getal (`float`) zijn. Als er geen snelheid wordt opgegeven, rijdt de robot met de huidige rijsnelheid.
`units`	Optioneel. De snelheidseenheid: `PERCENT` (standaard), `RPM` (rotaties per minuut) of `VelocityUnits.DPS` (graden per seconde).

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