Python#

Η αναφορά VEX EXP Python API εξηγεί τι κάνει κάθε εντολή, μέθοδος και συνάρτηση, ποιες εισόδους χρησιμοποιεί, τι επιστρέφει και πώς μπορεί να χρησιμοποιηθεί σε ένα έργο.

Χρησιμοποιήστε αυτήν την αναφορά όταν θέλετε να κατανοήσετε μια εντολή πριν την προσθέσετε σε ένα έργο, να ελέγξετε ποιες τιμές δέχεται ή επιστρέφει ή να συγκρίνετε σχετικές εντολές σε μια κατηγορία.

Οι εντολές Python χρησιμοποιούνται σε έργα Python VEXcode EXP. Τα μπλοκ και τα έργα C++ χρησιμοποιούν αντ’ αυτού τις άλλες ενότητες API.

Πώς να διαβάσετε μια καταχώρηση μεθόδου#

Οι περισσότερες καταχωρήσεις Python περιλαμβάνουν τα ακόλουθα μέρη:

Όνομα εντολής - Το επίσημο όνομα της εντολής, της μεθόδου ή της συνάρτησης.
Περιγραφή - Εξηγεί τι κάνει η εντολή και πότε είναι χρήσιμη.
Χρήση - Εμφανίζει τη σύνταξη που χρησιμοποιείται για την εγγραφή της εντολής στον κώδικα.
Παράμετροι - Παραθέτει τις εισόδους που δέχεται η εντολή και εξηγεί τι κάνει η καθεμία.
Επιστροφή τιμής - Εξηγεί τι αναφέρει η εντολή, εάν επιστρέφει μια τιμή.
Παράδειγμα κώδικα - Δείχνει έναν τρόπο με τον οποίο μπορεί να χρησιμοποιηθεί η εντολή σε ένα έργο.

Κοινά στοιχεία API Python#

Στοιχείο	Τι σημαίνει
Μέθοδος	Μια εντολή που καλείται σε ένα αντικείμενο όπως `drivetrain.drive(…)`.
Λειτουργία	Μια εντολή που καλείται απευθείας, όπως `wait(…)` ή `print(…)`.
Παράμετρος	Μια τιμή που μεταβιβάζεται σε μια μέθοδο ή συνάρτηση για να ελέγχει τι κάνει.
Προαιρετική παράμετρος	Μια παράμετρος που μπορεί να παραλειφθεί, ώστε να χρησιμοποιηθεί η προεπιλεγμένη συμπεριφορά.
Επιστρεφόμενη τιμή	Μια τιμή που αναφέρει μια εντολή, όπως ένας αριθμός, ένα κείμενο ή μια λογική τιμή.

Βασικό λεξιλόγιο Python#

Ορος	Τι σημαίνει
Μεταβλητός	Ένα όνομα που αποθηκεύει μια τιμή, όπως `speed = 50`.
Σειρά	Κείμενο μέσα σε εισαγωγικά, όπως `“Hello”`.
Ακέραιος αριθμός	Ένας θετικός ή αρνητικός αριθμός, όπως `90`.
Φλοτέρ	Ένας αριθμός με δεκαδικό ψηφίο, όπως `25.5`.
Λογική τιμή	Μια τιμή που είναι είτε `True` είτε `False`.
Επιχείρημα	Μια τιμή που διαβιβάζεται σε μια κλήση μεθόδου ή συνάρτησης, όπως `FORWARD` σε `drivetrain.drive(FORWARD)`.

Παράδειγμα εισαγωγής μεθόδου#

οδηγώ#

drive κινεί το ρομπότ προς τα εμπρός ή προς τα πίσω για πάντα. Το ρομπότ θα συνεχίσει να κινείται μέχρι να του δοθεί μια άλλη ενέργεια, όπως στροφή ή στάση.

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

Παράμετροι	Περιγραφή
`direction`	Η κατεύθυνση κίνησης του ρομπότ: `FORWARD` ή `REVERSE`.
`velocity`	Προαιρετικά. Η ταχύτητα με την οποία θα κινείται το ρομπότ κυμαίνεται από 0% έως 100% όταν χρησιμοποιείται `PERCENT`, από 0 έως 120 σ.α.λ. όταν χρησιμοποιούνται `RPM`ή από 0 έως 720 μοίρες ανά δευτερόλεπτο όταν χρησιμοποιούνται `VelocityUnits.DPS`Αυτή μπορεί να είναι ένας `integer` ή δεκαδικός αριθμός (`float`). Εάν δεν παρέχεται ταχύτητα, το ρομπότ κινείται με την τρέχουσα ταχύτητα κίνησης.
`units`	Προαιρετικά. Η μονάδα ταχύτητας: `PERCENT` (προεπιλογή), `RPM` (περιστροφές ανά λεπτό) ή `VelocityUnits.DPS` (μοίρες ανά δευτερόλεπτο).

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