Πύθων#

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

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

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

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

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

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

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

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

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

Ορος	Τι σημαίνει
Μεταβλητός	A name that stores a value, such as `speed = 50`.
Σειρά	Text inside quotes, such as `“Hello”`.
Ακέραιος αριθμός	A positive or negative number, such as `90`.
Φλοτέρ	A number with a decimal, such as `25.5`.
Λογική τιμή	A value that is either `True` or `False`.
Επιχείρημα	A value passed into a method or function call, such as `360.0` in `drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)`.

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

οδηγώ#

drive moves the robot forward or reverse forever. The robot will continue to move until it is given another action, like turning or stopping. For RPM or degrees per second, the limit is changed by the gear ratio of the drivetrain.

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

Παράμετροι	Περιγραφή
`direction`	The direction the robot moves: `FORWARD` or `REVERSE`.
`velocity`	Optional. The velocity to drive with from 0% to 100% when using `PERCENT`, from 0 to 600 rpm when using `RPM`, or from 0 to 3600 degrees per second when using `VelocityUnits.DPS`. This can be an `integer` or decimal (`float`). If no velocity is provided, the robot drives at the current drive velocity.
`units`	Optional. The velocity unit: `RPM` (rotations per minute, default), `PERCENT`, or `VelocityUnits.DPS` (degrees per second).

# Drive forward, then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)