يُحوّل#

مقدمة #

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

لتعلم كيفية كتابة أوامر بايثون والأساليب والمعاملات، راجع VEX 123 Python API.

لأن كتل Switch تحتوي على كود بايثون، يجب أن تكون التهجئة وعلامات الترقيم والمسافات البادئة صحيحة لكي يعمل المشروع كما هو متوقع.

فيما يلي قائمة بجميع وحدات التبديل:

تبديل الكتل — إضافة كود بايثون إلى مشروع Blocks.

Stack — يوفر مساحة لكتابة أوامر بايثون التي يتم تشغيلها بالتسلسل مع كتل المكدس الأخرى.
C Block — يوفر مساحة لكتابة كود التحكم في بايثون، مثل if، while، أو for statement.
C Expandable — يوفر مساحة لكتابة كود التحكم في بايثون مع فروع متعددة، مثل if، elif، أو else.
Boolean — يوفر مساحة لكتابة كود بايثون الذي يُرجع True أو False.
Reporter — يوفر مساحة لكتابة كود بايثون الذي يُرجع قيمة.
Hat — يوفر مساحة لتعريف دالة بايثون.

كومة #

توفر كتلة Stack مساحة لكتابة أوامر بايثون التي يتم تشغيلها بالتسلسل مع كتل المكدس الأخرى.

كتلة مكدسة#

[] :: custom-switch

يمكن أن تحتوي كتلة Stack على سطر واحد أو عدة أسطر من كود بايثون.

عند بدء التشغيل، يستخدم كتلة Stack للتحرك للأمام، ثم الانتظار، ثم التوقف.#

عند البدء :: hat events
[Drive forward, then stop.]
[robot.drive(FORWARD)] :: custom-switch
انتظر [2] ثانية
إيقاف القيادة

المبنى ج #

توفر كتلة التعليمات البرمجية C مساحة لكتابة تعليمات التحكم في ، مثل if، while، وfor وتُنفَّذ الكتل البرمجية الموجودة داخل كتلة التعليمات البرمجية C كجزء من بنية التحكم في بايثون.

المبنى ج#

if [] :: custom-switch
fin

يتضمن كود التحكم بلغة بايثون الذي يمكن استخدامه في كتلة C ما يلي:

if
while
for

عند بدء التشغيل، يستخدم كتلة C للتحرك للأمام عند الضغط على الزر الأيسر.#

عند البدء :: hat events
[Drive forward whenever the left button is pressed.]
للأبد
if [if robot.get_button(LEFT):] :: custom-switch
تشغيل [للأمام v] لمسافة [200] [مم v] ▶
fin
fin

ج قابل للتوسيع #

توفر كتلة C Expandable مساحة لكتابة كود تحكم بايثون متعدد الفروع، مثل if، elif، أو elseويمكن إضافة فروع إضافية عن طريق تحديد سهم الزائد.

كتلة قابلة للتوسيع من النوع ج#

if [] :: custom-switch-expand
fin

يتضمن كود التحكم بلغة بايثون الذي يمكن استخدامه في كتلة C Expandable ما يلي:

if
elif
else
while
for

عند بدء التشغيل، يستخدم البرنامج كتلة C قابلة للتوسيع للتوقف عند اكتشاف جسم ما، والاستمرار في العمل في غير ذلك.#

عند البدء :: hat events
[Drive forward if there is not an object in the way.]
للأبد
if [if robot.eye.is_object_detected():] :: custom-switch-expand
إيقاف القيادة
else [else:] :: custom-switch-expand
تشغيل [للأمام v] لمسافة [200] [مم v] ▶
fin
fin

منطقي #

توفر كتلة Boolean مساحة لكتابة كود بايثون الذي يُرجع True أو Falseويمكن وضعها داخل كتل ذات مدخلات سداسية.

كتلة منطقية#

<[] :: custom-switch>

يمكن أن تحتوي كتلة Boolean على شرط بايثون.

كتلة منطقية مع شرط بايثون#

<[robot.eye.is_object_detected()] :: custom-switch>

يمكن أيضًا استخدام عوامل التشغيل المنطقية في كتلة Boolean:

and
or
not

كتلة منطقية مع عامل منطقي في بايثون#

<[robot.get_button(LEFT) or robot.eye.is_object_detected()] :: custom-switch>

يمكن لكتلة Boolean استخدام عوامل المقارنة لمقارنة القيم:

أكبر من: >
أقل من: <
يساوي: ==
تتضمن عوامل المقارنة الأخرى <=، !=، و >=

كتلة منطقية مع عامل مقارنة بايثون#

<[robot.eye.get_brightness()> 50] :: custom-switch>

عند بدء التشغيل، يستخدم كتلة منطقية للتحرك للأمام كلما تم الضغط على الزر الأيسر.#

عند البدء :: hat events
[Drive forward whenever the left button is pressed.]
للأبد
إذا <[robot.get_button(LEFT)] :: custom-switch> إذن
تشغيل [للأمام v] لمسافة [200] [مم v] ▶
fin
fin

مراسل #

توفر كتلة Reporter مساحة لكتابة كود بايثون الذي يُرجع قيمة. ويمكن وضعها داخل كتل ذات مدخلات دائرية.

حجب المراسل#

([] :: custom-switch)

يمكن أن تحتوي كتلة Reporter على كود بايثون يقوم بإرجاع قيمة.

كتلة تقرير تحتوي على كود بايثون يُرجع قيمة#

([robot.eye.get_brightness()] :: custom-switch)

يمكن استخدام عوامل التشغيل الرياضية في كتلة Reporter:

الجمع: +
الطرح: -
القسمة: /
الضرب: *

كتلة مراسلة مع إضافة بايثون#

([robot.eye.get_brightness() + 10] :: custom-switch)

عند بدء التشغيل، يقوم البرنامج بطباعة سطوع العين.#

عند البدء :: hat events
[Print the eye brightness.]
اطبع ([robot.eye.get_brightness()] :: custom-switch) ▶

قبعة #

توفر كتلة Hat مساحة لتعريف دالة بايثون. وتصبح الكتل المرفقة أسفل Hat هي جسم تلك الدالة.

قالب قبعة#

[] :: hat custom-switch

اكتب تعريف دالة بايثون في كتلة Hat. تُوضع المعاملات داخل الأقواس. إذا لم تستخدم الدالة معاملات، فاستخدم أقواسًا فارغة.

كتلة قبعة مع تعريف دالة بايثون#

[def function_name(parameter):] :: hat custom-switch

عند بدء التشغيل، يستخدم كتلة Hat لتعريف واستدعاء دالة.#

[def drive_200():] :: hat custom-switch
[Define a custom function using a Hat block.]
تشغيل [للأمام v] لمسافة (200) [مم v] ▶

عند البدء :: hat events
[drive_200()] :: custom-switch

يُحوّل#

مقدمة#

كومة#

المبنى ج#

ج قابل للتوسيع#

منطقي#

مراسل#

قبعة#