عرض مصدر Arduino/switchcase

يتحقَّق التعبير <code>switch...case</code> -كما في <code>[[Arduino/if|if]]</code>- من قيمة محدَّدة بطريقة تسمح للمبرمج بتحديد شيفرة معينة يراد تنفيذها بناءً على حالات مختلفة. بتفصيلٍ أوسع، يوازن التعبير  <code>switch...case</code> قيمة متغير مع القيم المحددة ضمنه؛ عند مطابقة قيمة ذلك المتغير مع إحدى القيم أو التعابير الموجودة ضمنه، فستُنفَّذ الكتلة البرمجية المرتبطة بتلك القيمة أو التعبير.

تستخدم عادةً الكلمة المفتاحية <code>break</code> في نهاية كل حالة من حالات التعبير <code>switch...case</code> للخروج منه بعد مطابقة الحالة وتنفيذ الكتلة المرتبطة بها. إن لم تُستعمَل الكلمة <code>break</code> المفتاحية في تلك الحالة، فسيستمر التعبير <code>switch...case</code> بفحص الحالات وتنفيذ الكتل البرمجية المرتبطة بها حتى الوصول إلى الكلمة <code>break</code> أو إلى نهايته.

==البنية العامة==
<syntaxhighlight lang="arduino">
switch (var) {
  case label1:
    // الشيفرة الأولى التي ستنفذ عند مطابقة الحالة الأولى
    break;
  case label2:
    // الشيفرة الثانية التي ستنفذ عند مطابقة الحالة الثانية
    break;
  default:
    // الشيفرة الافتراضية التي ستنفذ عند عدم مطابقة أية حالة
    // هذه الحالة اختيارية
}
</syntaxhighlight>

== المعاملات ==

=== <code>var</code> ===
المتغير المراد موازنة قيمته مع عدة قيم (حالات). أنواع البيانات المسموح بها هي: [[Arduino/int|عدد صحيح]]، [[Arduino/char|ومحرف]].

=== <code>lable1</code> ===
الثابت الأول الذي سيوازن مع المتغير <code>var</code>. أنواع البيانات المسموح بها هي: [[Arduino/int|عدد صحيح]]، [[Arduino/char|ومحرف]].

=== <code>lable2</code> ===
الثابت الأول الذي سيوازن مع المتغير <code>var</code>. أنواع البيانات المسموح بها هي: [[Arduino/int|عدد صحيح]]، [[Arduino/char|ومحرف]].

==أمثلة==
مثالٌ على استعمال التعبير <code>switch...case</code> لموازنة قيمة متغير وتنفيذ شيفرة بما يناسبها:<syntaxhighlight lang="arduino">
  switch (var) {
    case 1:
      // القيمة 1 var افعل شيئًا عندما يساوي
      break;
    case 2:
      // القيمة 2 var افعل شيئًا عندما يساوي
      break;
    default:
      // مع أي من القيم السابقة var افعل شيئًا إن لم يتطابق 
      break;
  }
</syntaxhighlight>
==انظر أيضًا==
*الكلمة المفتاحية <code>[[Arduino/break|break]]</code>: تُستعمَل للخروج من الحلقات التكرارية، إذ تتخطى الشيفرة التي بعدها وشروط الحلقة المحددِّة وتخرج منها.
*الحلقة <code>do...while</code>:
*التعبير <code>[[Arduino/else|else]]</code>:
*الحلقة <code>[[Arduino/for|for]]</code>:
*الكلمة المفتاحية <code>[[Arduino/goto|goto]]</code>:
*الحلقة <code>if...else</code>:
*الكلمة المفتاحية <code>[[Arduino/return|return]]</code>:
*الحلقة <code>[[Arduino/while|while]]</code>:
==مصادر==
*[https://www.arduino.cc/reference/en/language/structure/control-structure/switchcase/ صفحة التعبير switch...case في توثيق أردوينو الرسمي.]