Python#

Die VEX GO 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 GO Python-Projekten werden Python-Befehle verwendet. Blocks-Projekte nutzen stattdessen den Abschnitt der Blocks-API.

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. distance = 200.

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. FORWARD in drivetrain.drive(FORWARD).

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)

Parameter

Beschreibung

direction

Die Bewegungsrichtung des Roboters: FORWARD oder REVERSE.

# Build Used: Code Base 2.0
def main():
    # Drive forward then stop
    drivetrain.drive(FORWARD)
    wait(2, SECONDS)
    drivetrain.stop()

# Start threads - Do not delete
start_thread(main)