Python#

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

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

تُستخدم أوامر بايثون في مشاريع بايثون الخاصة بـ VEXcode IQ (الجيل الثاني). أما مشاريع Blocks وC++ فتستخدم أقسام واجهة برمجة التطبيقات الأخرى بدلاً من ذلك.

ملاحظة: يُشغّل معالج IQ (الجيل الثاني) لغة بايثون عبر آلة افتراضية ذات ذاكرة محدودة. ورغم وجود حد أقصى لحجم الكود المصدري، فإن تشغيل البرنامج يعتمد أيضًا على مدى تعقيده (مثل عدد الدوال والمتغيرات والمنطق المستخدم). ونتيجةً لذلك، قد تفشل البرامج الكبيرة أو المعقدة في التجميع أو التشغيل حتى لو كانت ضمن الحد الأقصى للحجم. أما برامج C/C++ فهي أقل تأثرًا بهذه القيود على معالج IQ (الجيل الثاني).

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

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

اسم الأمر - الاسم الرسمي للأمر أو الطريقة أو الوظيفة.
الوصف - يشرح ما يفعله الأمر ومتى يكون مفيدًا.
الاستخدام - يعرض الصيغة المستخدمة لكتابة الأمر في التعليمات البرمجية.
المعلمات - تسرد المدخلات التي يقبلها الأمر وتشرح وظيفة كل منها.
القيمة المُعادة - يشرح ما يُبلغه الأمر، إذا أعاد قيمة.
مثال على الكود - يوضح إحدى طرق استخدام الأمر في مشروع ما.

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

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

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

شرط	ماذا يعني ذلك؟
عامل	اسم يخزن قيمة، مثل `speed = 50`.
خيط	النص الموجود داخل علامات الاقتباس، مثل `“Hello”`.
عدد صحيح	رقم موجب أو سالب، مثل `90`.
يطفو	رقم يحتوي على فاصلة عشرية، مثل `25.5`.
منطقي	قيمة إما `True` أو `False`.
دعوى	قيمة يتم تمريرها إلى طريقة أو استدعاء دالة، مثل `REVERSE` في `drivetrain.drive(REVERSE, 20, PERCENT)`.

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

يقود#

يُحرّك الأمر drive الروبوت للأمام أو للخلف باستمرار. سيستمر الروبوت في الحركة حتى يُعطى أمرًا آخر، مثل الانعطاف أو التوقف.

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

حدود	وصف
`direction`	اتجاه حركة الروبوت: `FORWARD` أو `REVERSE`.
`velocity`	Optional. The velocity to drive with from 0% to 100% when using `PERCENT`, from 0 to 120 rpm when using `RPM`, or from 0 to 720 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`	اختياري. وحدة السرعة: `PERCENT` (افتراضي)، `RPM` (دورات في الدقيقة)، أو `VelocityUnits.DPS` (درجات في الثانية).

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

# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()