Python#

Referensi API Python VEX V5 menjelaskan apa yang dilakukan oleh setiap perintah, metode, dan fungsi, input apa yang digunakannya, apa yang dikembalikannya, dan bagaimana cara menggunakannya dalam sebuah proyek.

Gunakan referensi ini ketika Anda ingin memahami suatu perintah sebelum menambahkannya ke proyek, memeriksa nilai apa yang diterima atau dikembalikan, atau membandingkan perintah terkait dalam suatu kategori.

Perintah Python digunakan dalam proyek Python VEXcode V5. Proyek Blocks dan C++ menggunakan bagian API lainnya.

Cara Membaca Entri Metode#

Sebagian besar entri Python mencakup bagian-bagian berikut:

Nama perintah - Nama resmi dari perintah, metode, atau fungsi.
Deskripsi - Menjelaskan fungsi perintah dan kapan perintah tersebut berguna.
Penggunaan - Menunjukkan sintaks yang digunakan untuk menulis perintah dalam kode.
Parameter - Mencantumkan input yang diterima oleh perintah dan menjelaskan fungsi masing-masing input.
Nilai kembalian - Menjelaskan apa yang dilaporkan oleh perintah, jika perintah tersebut mengembalikan nilai.
Contoh kode - Menunjukkan salah satu cara perintah ini dapat digunakan dalam sebuah proyek.

Elemen API Python Umum#

Elemen	Apa artinya
Metode	Perintah yang dipanggil pada suatu objek seperti `drivetrain.drive(…)`.
Fungsi	Perintah yang dipanggil secara langsung, seperti `wait(…)` atau `print(…)`.
Parameter	Nilai yang diteruskan ke suatu metode atau fungsi untuk mengontrol apa yang dilakukannya.
Parameter opsional	Parameter yang dapat diabaikan sehingga perilaku default yang digunakan.
Nilai kembalian	Nilai yang dilaporkan kembali oleh suatu perintah, seperti angka, teks, atau Boolean.

Kosakata Dasar Python#

Ketentuan	Apa artinya
Variabel	Nama yang menyimpan nilai, seperti `speed = 50`.
Rangkaian	Teks di dalam tanda kutip, seperti `“Hello”`.
Bilangan bulat	Angka positif atau negatif, seperti `90`.
Mengambang	Angka dengan desimal, seperti `25.5`.
Boolean	Nilai yang berupa `True` atau `False`.
Argumen	Nilai yang diteruskan ke panggilan metode atau fungsi, seperti `360.0` in `drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)`.

Contoh Entri Metode#

menyetir#

drive menggerakkan robot maju atau mundur selamanya. Robot akan terus bergerak hingga diberi tindakan lain, seperti berbelok atau berhenti. Untuk RPM atau derajat per detik, batasnya diubah oleh rasio gigi dari sistem penggerak.

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

Parameter	Keterangan
`direction`	Arah pergerakan robot: `FORWARD` atau `REVERSE`.
`velocity`	Opsional. Kecepatan penggerak dari 0% hingga 100% saat menggunakan `PERCENT`, dari 0 hingga 600 rpm saat menggunakan `RPM`, atau dari 0 hingga 3600 derajat per detik saat menggunakan `VelocityUnits.DPS`Ini dapat berupa bilangan bulat `integer` (bilangan pecahan`float`). Jika tidak ada kecepatan yang diberikan, robot akan bergerak dengan kecepatan penggerak saat ini.
`units`	Opsional. Satuan kecepatan: `RPM` (putaran per menit, default), `PERCENT`, atau `VelocityUnits.DPS` (derajat per detik).

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