Python

يشرح مرجع واجهة برمجة تطبيقات بايثون VEX CTE ما يفعله كل أمر وطريقة ووظيفة، وما هي المدخلات التي يستخدمها، وما الذي يعيده، وكيف يمكن استخدامه في مشروع.

استخدم هذا المرجع عندما تريد فهم أمر ما قبل إضافته إلى مشروع، أو التحقق من القيم التي يقبلها أو يعيدها، أو مقارنة الأوامر ذات الصلة في فئة معينة.

تُستخدم أوامر بايثون في مشاريع VEXcode بايثون. أما مشاريع Blocks فتستخدم قسم Blocks API بدلاً من ذلك.

كيفية قراءة مدخلات الأسلوب

تتضمن معظم إدخالات بايثون الأجزاء التالية:

• اسم الأمر - الاسم الرسمي للأمر أو الطريقة أو الوظيفة.

• الوصف - يشرح ما يفعله الأمر ومتى يكون مفيدًا.

• الاستخدام - يعرض الصيغة المستخدمة لكتابة الأمر في التعليمات البرمجية.

• المعلمات - تسرد المدخلات التي يقبلها الأمر وتشرح وظيفة كل منها.

• القيمة المُعادة - يشرح ما يُبلغه الأمر، إذا أعاد قيمة.

• مثال على الكود - يوضح إحدى طرق استخدام الأمر في مشروع ما.

عناصر واجهة برمجة تطبيقات بايثون الشائعة

عنصر	ماذا يعني ذلك؟
طريقة	يتم استدعاء أمر على كائن مثل arm.move_inc(…).
وظيفة	أمر يتم استدعاؤه مباشرة، مثل wait(…) أو print(…).
المَعْلَمة	قيمة يتم تمريرها إلى طريقة أو دالة للتحكم في ما تفعله.
معامل اختياري	معلمة يمكن حذفها لاستخدام السلوك الافتراضي.
القيمة المُعادة	قيمة يُبلغ عنها الأمر، مثل رقم أو نص أو قيمة منطقية.

مفردات بايثون الأساسية

شرط	ماذا يعني ذلك؟
عامل	اسم يخزن قيمة، مثل x_target = 120.
خيط	النص الموجود داخل علامات الاقتباس، مثل “Hello”.
عدد صحيح	رقم موجب أو سالب، مثل 90.
يطفو	رقم يحتوي على فاصلة عشرية، مثل 25.5.
منطقي	قيمة إما True أو False.
دعوى	قيمة يتم تمريرها إلى طريقة أو استدعاء دالة، مثل 100 في arm.move_inc(0, 100, 0).

مثال على إدخال الطريقة

move_inc

move_inc يحرك الذراع ذو المحاور الستة بمسافة محددة على طول المحاور x و y و z.

ستُعيد هذه الطريقة قيمة منطقية تُشير إلى ما إذا كان ذراع المحور السداسي قد وصل إلى الموضع المطلوب أم لا:

• True - وصل الذراع ذو المحاور الستة إلى الموضع المطلوب.

• False - لا يمكن للذراع ذي المحاور الستة الوصول إلى الموضع المطلوب.

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

المعلمة	وصف
x	المسافة التي يجب التحرك بها على طول المحور السيني بالملليمترات.
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)