Πύθων#

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

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

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

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

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

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

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

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

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

Ορος	Τι σημαίνει
Μεταβλητός	A name that stores a value, such as `x_target = 120`.
Σειρά	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 `100` in `arm.move_inc(0, 100, 0)`.

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

move_inc#

move_inc moves the 6-Axis Arm by a specified distance along the x, y, and z axes.

Αυτή η μέθοδος θα επιστρέψει μια λογική τιμή που υποδεικνύει εάν ο βραχίονας 6 αξόνων έχει φτάσει στην ζητούμενη θέση:

True - The 6-Axis Arm has reached the requested position.
False - The 6-Axis Arm cannot reach the requested position.

Usage:
arm.move_inc(x, y, z, wait)

Παράμετρος	Περιγραφή
χ	Η απόσταση που απαιτείται για την κίνηση κατά μήκος του άξονα x σε χιλιοστά.
y	Η απόσταση που απαιτείται για να κινηθεί κανείς κατά μήκος του άξονα y σε χιλιοστά.
z	Η απόσταση που απαιτείται για την κίνηση κατά μήκος του άξονα z σε χιλιοστά.
`wait`	Optional. `wait=True` (default) - The project waits until `move_inc` is complete before executing the next line of code. `wait=False` - The project starts the action and moves on to the next line of code right away, without waiting for `move_inc` to finish.

# Move the Arm +100 millimeters on the y-axis
arm.move_inc(0, 100, 0)