Python

เอกสารอ้างอิง VEX CTE Python API อธิบายว่าคำสั่ง เมธอด และฟังก์ชันแต่ละรายการทำอะไร รับอินพุตอะไรบ้าง ส่งคืนค่าอะไร และสามารถนำไปใช้ในโปรเจ็กต์ได้อย่างไร

ใช้เอกสารอ้างอิงนี้เมื่อคุณต้องการทำความเข้าใจคำสั่งก่อนที่จะเพิ่มลงในโปรเจ็กต์ ตรวจสอบค่าที่คำสั่งนั้นยอมรับหรือส่งคืน หรือเปรียบเทียบคำสั่งที่เกี่ยวข้องในหมวดหมู่เดียวกัน

คำสั่ง Python ถูกใช้ในโปรเจ็กต์ Python ของ VEXcode ส่วนโปรเจ็กต์ Blocks จะใช้ส่วน API ของ Blocks แทน

วิธีการอ่านข้อมูลเมธอด

บทความเกี่ยวกับ Python ส่วนใหญ่ประกอบด้วยส่วนต่างๆ ดังต่อไปนี้:

• ชื่อคำสั่ง - ชื่ออย่างเป็นทางการของคำสั่ง เมธอด หรือฟังก์ชัน

• คำอธิบาย - อธิบายว่าคำสั่งนี้ทำอะไรและมีประโยชน์เมื่อใด

• วิธีใช้งาน - แสดงไวยากรณ์ที่ใช้ในการเขียนคำสั่งในโค้ด

• พารามิเตอร์ - แสดงรายการอินพุตที่คำสั่งยอมรับและอธิบายว่าแต่ละพารามิเตอร์ทำอะไรบ้าง

• ค่าที่ส่งกลับ - อธิบายว่าคำสั่งนั้นส่งค่าอะไรกลับมา หากมีการส่งค่ากลับมา

• ตัวอย่างโค้ด - แสดงวิธีการใช้งานคำสั่งนี้ในโปรเจ็กต์

องค์ประกอบ API ทั่วไปของ Python

องค์ประกอบ	มันหมายความว่าอย่างไร
วิธี	คำสั่งที่เรียกใช้กับวัตถุ เช่น arm.move_inc(…).
การทำงาน	คำสั่งที่เรียกใช้โดยตรง เช่น wait(…) หรือ print(…)
พารามิเตอร์	ค่าที่ส่งเข้าไปในเมธอดหรือฟังก์ชันเพื่อควบคุมการทำงานของมัน
พารามิเตอร์เสริม	พารามิเตอร์ที่สามารถละเว้นได้เพื่อให้ระบบใช้พฤติกรรมเริ่มต้น
ค่าที่ส่งคืน	ค่าที่คำสั่งส่งกลับมา เช่น ตัวเลข ข้อความ หรือค่าบูลีน

คำศัพท์พื้นฐานของ Python

ภาคเรียน	มันหมายความว่าอย่างไร
ตัวแปร	ชื่อที่เก็บค่า เช่น x_target = 120
สตริง	ข้อความภายในเครื่องหมายคำพูด เช่น “Hello”.
จำนวนเต็ม	ตัวเลขบวกหรือลบ เช่น 90
ลอย	ตัวเลขที่มีจุดทศนิยม เช่น 25.5
บูลีน	ค่าที่ได้คือ True หรือ False)
การโต้แย้ง	ค่าที่ส่งผ่านเข้าไปในการเรียกเมธอดหรือฟังก์ชัน เช่น 100 ใน arm.move_inc(0, 100, 0).

ตัวอย่างการป้อนข้อมูลวิธีการ

ย้าย_อินค์

คำสั่ง move_inc จะเคลื่อนแขนกล 6 แกนไปตามระยะทางที่กำหนดในแนวแกน x, y และ z

เมธอดนี้จะส่งคืนค่าบูลีนที่ระบุว่าแขนกล 6 แกนได้ถึงตำแหน่งที่ร้องขอแล้วหรือไม่:

• True - แขนกล 6 แกนได้เคลื่อนที่ไปยังตำแหน่งที่ต้องการแล้ว

• False - แขนกล 6 แกนไม่สามารถไปถึงตำแหน่งที่ต้องการได้

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

พารามิเตอร์	คำอธิบาย
x	ระยะทางที่ต้องเคลื่อนที่ไปตามแกน x ในหน่วยมิลลิเมตร
y	ระยะทางที่ต้องเคลื่อนที่ไปตามแกน y ในหน่วยมิลลิเมตร
z	ระยะทางในการเคลื่อนที่ตามแกน z ในหน่วยมิลลิเมตร
wait	ตัวเลือกเสริม wait=True (ค่าเริ่มต้น) - โปรเจ็กต์จะรอจนกว่า move_inc จะเสร็จสมบูรณ์ก่อนที่จะดำเนินการโค้ดบรรทัดถัดไป wait=False - โปรเจ็กต์จะเริ่มการทำงานและดำเนินการต่อในโค้ดบรรทัดถัดไปทันที โดยไม่ต้องรอให้ move_inc เสร็จสิ้น

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