تعلّم

Arduino enum، على مؤقّت بومودورو يعرف في أي جلسة هو

مبتدئ

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: مؤقّت بومودورو يحفظ جلسته في enumمباشر0.000 s 0.00x
اضغط «تشغيل» ثم اضغط زر التخطي
اضغط زر «التخطي» لتنتقل بالـ enum: تركيز، فاستراحة قصيرة، فتركيز مجددًا.

enum Phase { FOCUS, SHORT_BREAK, LONG_BREAK }; تعطي أسماء للأعداد الكاملة 0 و1 و2، وتجعل Phase نوعًا يحمل واحدًا منها. ومتغيّر من هذا النوع يقول بأي حالة يكون البرنامج، بكلمات بدل أرقام، وswitch عليه يعطي كل حالة كتلتها الخاصة.

الدائرة أعلاه مؤقّت بومودورو على لوحة Uno: شاشة TM1637، ومصباح تركيز أحمر، ومصباح استراحة أخضر، وزرّان. يحفظ الكود الجلسة في Phase phase. اضغط «تشغيل» ثم اضغط الزر الثاني، تخطي. ستطبع الشاشة التسلسلية "Skipped" و"Short break (1 session done)"، ويتولى المصباح الأخضر مكان الأحمر. تخطَّ مرة أخرى فتطبع "Focus (1 session done)".

فيما يلي كيف تقابل الأسماءُ الأرقامَ، وطباعة enum بالاسم، وenum مع switch، وenum class، والأخطاء التي يعطيها enum، كلٌّ منها مُشغَّل على لوحة Uno مع ما طبعه.

الـ enum الخاص بالمؤقّت

Here are the two lines from the sketch running above. : uint8_t stores a Phase in one byte; without it an enum on the Uno takes 2, the size of an int. The sketch then reads like the method it follows: if (phase == FOCUS), phase = LONG_BREAK. Nothing at run time knows the names. They are for you and for the compiler, which now refuses a phase that is not one of the three.

firmware/uno/examples/pomodoro (الـ enum المشغَّل أعلاه)
enum Phase : uint8_t { FOCUS, SHORT_BREAK, LONG_BREAK };
Phase phase = FOCUS;

الأرقام الكامنة خلف الأسماء

الاسم الأول هو 0 وكل اسم بعده يزيد واحدًا، إلا إذا أعطيته قيمة. أدناه، Serial.println(c) مع c مضبوطة على BLUE طبع 2، وطبع FAST الرقم 50 لأنها أُعطيت 50. وطبع sizeof(Color) الرقم 2. القيم مفيدة عندما تعني الأرقام شيئًا خارج الكود، مثل سرعة أو بايت أمر.

يمكن لاسمين أن يتشاركا قيمة، ويمكن إعطاء اسم قيمة اسم آخر زائد واحد، MEDIUM = SLOW + 15. والأسماء المتروكة بلا قيمة تواصل العدّ من آخر اسم له قيمة، فبعد SLOW = 10، تكون FASTER وحدها 11. أبقِ القائمة في مكان واحد في أعلى الكود، حيث تُقرأ كل حالة يمكن أن يكون عليها البرنامج بنظرة واحدة.

الأسماء أرقام
enum Color { RED, GREEN, BLUE };
enum Speed { SLOW = 10, MEDIUM = 25, FAST = 50 };

void setup() {
  Serial.begin(9600);
  Color c = BLUE;
  Serial.println(c);
  Serial.println(FAST);
  Serial.println(sizeof(Color));
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

طباعة enum بالاسم

‏Serial.println() يطبع الرقم، لا الاسم أبدًا. لطباعة الاسم، احفظ الأسماء في مصفوفة بالترتيب نفسه واستخدم الـ enum كفهرس: الكود أدناه طبع "green". وكود بومودورو يفعل ذلك بدالة تعيد "Focus" أو "Short break" أو "Long break"، وهو أأمن عندما تُعطى القيم يدويًا، لأن الأسماء حينها لا تطابق مواضعها في مصفوفة.

enum كفهرس
enum Color { RED, GREEN, BLUE };
const char *colorNames[] = {"red", "green", "blue"};

void setup() {
  Serial.begin(9600);
  Color c = GREEN;
  Serial.println(colorNames[c]);
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

enum وswitch

‏switch على enum هو الشكل المعتاد لآلة حالات: حالة واحدة في كل case، كلٌّ يقوم بعمله ويختار الحالة التالية. اترك حالة خارجًا فيلاحظ المترجم. الكود أدناه فيه ثلاثة أضواء وحالتان فقط؛ وحذّر clang: enumeration value 'YELLOW' not handled in switch، وطبع الكود "red" و"green" ثم لا شيء، لأنه وصل إلى YELLOW ولا case له. أضف الحالة، أو default: عن قصد.

switch بناقص حالة
enum Light { RED, GREEN, YELLOW };
Light light = RED;

void setup() {
  Serial.begin(9600);
}

void loop() {
  switch (light) {
    case RED:
      Serial.println("red");
      light = GREEN;
      break;
    case GREEN:
      Serial.println("green");
      light = YELLOW;
      break;
  }
  delay(100);
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

enum class: أسماء تبقى في صندوقها الخاص

أسماء الـ enum العادي تعود على الكود كله، وتتحول بهدوء إلى ints. وenum class يمنع الأمرين: اكتب النوع قبل كل اسم، Mode::Blink، وقارن مع Modes أخرى فقط. الكود أدناه طبع "blinking"، وطبع (int)m الرقم 1.

الثمن أنه لا يمرّ كرقم. توقف Serial.println(m) مع no matching member function for call to 'println'، وif (m == 1) مع invalid operands to binary expression ('Mode' and 'int')، مضيفًا clang لا تحويل ضمنيًا للـ enum المحدَّد النطاق. أما GCC فيقول no match for 'operator=='. حوّله بالتصريح، (int)m، عندما تريد الرقم فعلًا.

enum class
enum class Mode { Off, Blink, On };

void setup() {
  Serial.begin(9600);
  Mode m = Mode::Blink;
  if (m == Mode::Blink) {
    Serial.println("blinking");
  }
  Serial.println((int)m);
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

الأخطاء التي يعطيها enum

اسم تستخدمه Arduino سابقًا: enum Level { LOW, MEDIUM, HIGH }; توقف مع expected identifier، مرتين، لأن LOW وHIGH معرّفان سابقًا بأنهما 0 و1 قبل أن يبدأ كودك. اختر أسماء أخرى، مثل LEVEL_LOW، أو استخدم enum class.

الاسم نفسه في تعدادين: OFF في تعداد لمصباح وآخر لمروحة تسبب في إعادة تعريف العدّاد 'OFF'؛ يقول GCC إن 'OFF' يتعارض مع تصريح سابق. أسماء التعدادات العادية تتشارك فضاء واحد للأسماء، لذا أضف لها بادئة أو استخدم enum class.

العدّ عبره: c++ على Color توقفت مع cannot increment expression of enum type 'Color'، وColor c = 2; مع cannot initialize a variable of type 'Color' with an rvalue of type 'int'؛ وGCC يقول invalid conversion from 'int' to 'Color'. تنقّل عبره بالتصريح، c = (Color)((c + 1) % 3);، والذي ذهب إلى 0 و1 و2 ثم عاد إلى 0.

افتح هذه الدائرة في المحرر. Arduino Uno: مؤقّت بومودورو يحفظ جلسته في enum، موصَّلًا كما يعمل أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّله مرة أخرى.

افتح الدائرة

الأسئلة

ما هو enum في Arduino؟

قائمة أسماء للأعداد الكاملة تصنع أيضًا نوعًا جديدًا. هكذا يسمّي الكود حالاته وأوضاعه وعناصر قائمته بحيث يقول الكود FOCUS بدلًا من 0.

كيف أطبع اسم enum؟

احفظ الأسماء في مصفوفة const char * بالترتيب نفسه واطبع colorNames[c]، أو اكتب دالة بـ switch تعيد الاسم. أما Serial.println() وحده فيطبع الرقم.

هل enum أفضل من #define للحالات؟

نعم. الـ enum يعطي نوعًا حقيقيًا، فيستطيع المترجم رفض قيمة ليست حالة والتحذير عندما تفوت switch حالة. أما الأسماء المصنوعة بـ #define فهي نص يُستبدل قبل الترجمة فقط.

ما الفرق بين enum وenum class؟

أسماء الـ enum العادي مرئية في كل مكان وتتحول إلى أعداد صحيحة من تلقاء نفسها. أما enum class فيُبقي أسماءه داخل نوعه، مثل Mode::On، ويحتاج إلى تحويل صريح ليصبح رقمًا، ولذلك يمكن لاثنين من الـ enums أن يحتوي كل منهما على OFF.

المصادر

من أين جاءت الحقائق في هذه الصفحة

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.