Python#

Die VEX IQ (2. Generation) Python API-Referenz erklärt, was jeder Befehl, jede Methode und jede Funktion bewirkt, welche Eingaben sie verwendet, was sie zurückgibt und wie sie in einem Projekt verwendet werden kann.

Nutzen Sie diese Referenz, wenn Sie einen Befehl verstehen möchten, bevor Sie ihn einem Projekt hinzufügen, überprüfen möchten, welche Werte er akzeptiert oder zurückgibt, oder wenn Sie verwandte Befehle in einer Kategorie vergleichen möchten.

In VEXcode IQ (2. Generation) Python-Projekten werden Python-Befehle verwendet. Blocks- und C+±Projekte nutzen stattdessen die anderen API-Bereiche.

Hinweis: Der IQ Brain (2. Generation) führt Python in einer virtuellen Maschine mit begrenztem Speicher aus. Es gibt zwar eine maximale Quellcodegröße, die Ausführung eines Programms hängt jedoch auch von seiner Komplexität ab (z. B. Anzahl der Funktionen, Variablen und der verwendeten Logik). Daher können große oder komplexe Programme selbst dann nicht kompiliert oder ausgeführt werden, wenn sie die Größenbeschränkung einhalten. C/C+±Programme sind von diesen Einschränkungen auf dem IQ Brain (2. Generation) im Allgemeinen weniger betroffen.

Wie man einen Methodeneintrag liest#

Die meisten Python-Einträge enthalten die folgenden Bestandteile:

Befehlsname - Der offizielle Name des Befehls, der Methode oder der Funktion.
Beschreibung - Erklärt, was der Befehl bewirkt und wann er nützlich ist.
Verwendung - Zeigt die Syntax, die zum Schreiben des Befehls im Code verwendet wird.
Parameter - Listet die Eingaben auf, die der Befehl akzeptiert, und erklärt, was jede einzelne bewirkt.
Rückgabewert - Erklärt, was der Befehl zurückgibt, falls er einen Wert zurückgibt.
Beispielcode - Zeigt eine Möglichkeit, wie der Befehl in einem Projekt verwendet werden kann.

Gemeinsame Python-API-Elemente#

Element	Was es bedeutet
Verfahren	Ein Befehl, der auf einem Objekt wie z. B. `drivetrain.drive(…)` aufgerufen wird.
Funktion	Ein direkt aufgerufener Befehl, wie z. B. `wait(…)` oder `print(…)`.
Parameter	Ein Wert, der an eine Methode oder Funktion übergeben wird, um deren Verhalten zu steuern.
Optionaler Parameter	Ein Parameter, der weggelassen werden kann, sodass das Standardverhalten verwendet wird.
Rückgabewert	Ein Wert, den ein Befehl zurückgibt, z. B. eine Zahl, ein Text oder ein boolescher Wert.

Grundlegendes Python-Vokabular#

Begriff	Was es bedeutet
Variable	Ein Name, der einen Wert speichert, z. B. `speed = 50`.
String	Text innerhalb von Anführungszeichen, wie z. B. `“Hello”`.
Ganze Zahl	Eine positive oder negative Zahl, z. B. `90`.
Schweben	Eine Zahl mit Dezimalstellen, wie zum Beispiel `25.5`.
Boolesch	Ein Wert, der entweder `True` `False` ist.
Argument	Ein Wert, der an einen Methoden- oder Funktionsaufruf übergeben wird, z. B. `REVERSE` in `drivetrain.drive(REVERSE, 20, PERCENT)`.

Beispiel für Methodeneingabe#

fahren#

drive endlos. Der Roboter bewegt sich so lange, bis ihm eine andere Aktion zugewiesen wird, z. B. Drehen oder Anhalten.

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

Parameter	Beschreibung
`direction`	Die Bewegungsrichtung des Roboters: `FORWARD` oder `REVERSE`.
`velocity`	Optional. Die Fahrgeschwindigkeit kann zwischen 0 % und 100 % (bei Verwendung von `PERCENT`, 0 und 120 U/min (bei Verwendung `RPM`) oder 0 und 720 Grad pro Sekunde (bei Verwendung von `VelocityUnits.DPS`) liegen. Es kann sich um eine Ganzzahl `integer` oder eine Dezimalzahl (`float`) handeln. Wird keine Geschwindigkeit angegeben, fährt der Roboter mit der aktuellen Fahrgeschwindigkeit.
`units`	Optional. Die Geschwindigkeitseinheit: `PERCENT` (Standard), `RPM` (Umdrehungen pro Minute) oder `VelocityUnits.DPS` (Grad pro Sekunde).

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