تعلّم

حلقة for في Arduino، مع ثمانية LED تشتعل بالتتابع

متوسط

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: تأثير مطاردة LED باستخدام 74HC595مباشر0.000 s 0.00x
اضغط لفتحه في المحرر
أربع حلقات for: العمود يمتلئ، العمود يفرغ، النقطة تجري يمينًا، والنقطة تعود.

حلقة for تشغّل الأسطر نفسها عددًا محددًا من المرات. for (int i = 0; i < 8; i++) تشغّل كتلتها ثماني مرات، مع i الذي يعدّ 0 و1 و2 حتى 7، وهي الطريقة التي يمشي بها الكود على صف من LED، أو يعزف قائمة نغمات، أو يقرأ صفًا من الحساسات دون كتابة السطر نفسه ثماني مرات.

الدائرة أعلاه هي Uno تقود ثمانية LED عبر مسجّل إزاحة 74HC595. اضغط «تشغيل». يمتلئ عمود من اليسار مصباحًا تلو الآخر، ثم يفرغ، ثم تجري نقطة واحدة إلى اليمين وتعود. هذا العرض كله هو أربع حلقات for، متتابعة، داخل loop().

في الأسفل أجزاء for الثلاثة، ثم العدّ التنازلي والعدّ بخطوات، وحلقة داخل حلقة، وbreak وcontinue، والأخطاء الثلاثة التي يقع فيها الجميع، كل منها يعمل على Uno مع المخرج الذي طبَعه.

تريد النسخة خطوة بخطوة؟ الدرس "حلقة فوق قائمة" يشرح ذلك مع نقاط تحقق.

افتح الدرس

الأجزاء الثلاثة

داخل القوسين ثلاثة أجزاء تفصل بينها فواصل منقوطة. الأول يعمل مرة واحدة قبل كل شيء: int i = 0 ينشئ عدّادًا ويبدأه من الصفر. الثاني يُفحص قبل كل دورة، ولا تستمر الحلقة إلا وهو صحيح: i < 5. والثالث يعمل في نهاية كل دورة: i++ يضيف واحدًا.

فالحلقة أدناه تعمل وi يساوي 0، ثم 1 و2 و3 و4، وقد طبَعت "0 1 2 3 4". عندما يصل i إلى 5 يصبح الشرط خاطئًا، وتتوقف الحلقة ويواصل الكود عمله بعد قوس الإغلاق. العدّاد موجود داخل الحلقة فقط. استخدم i بعد القوس وسيتوقف البناء: يقول Arduino IDE‏: 'i' was not declared in this scope، ويقول clang في Mokxi‏: use of undeclared identifier 'i'.

العدّ حتى خمسة
void setup() {
  Serial.begin(9600);
  for (int i = 0; i < 5; i++) {
    Serial.print(i);
    Serial.print(' ');
  }
  Serial.println();
}

void loop() {
}

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

حلقات المطاردة الأربع

هذا هو الكود الذي يعمل أعلاه. show() ترسل بايتًا واحدًا إلى مسجّل الإزاحة، بت واحد لكل مصباح. الحلقة الأولى تعدّ n من 1 إلى 8 وتضيء أول n مصباح، فينمو العمود. والثانية تعدّ تنازليًا من 7 إلى 0 بـn--، فيتقلّص العمود. والأخيرتان تنقلان بتًا واحدًا مضيئًا يمينًا ثم عودة، ورحلة العودة تتوقف عند 1 لا 0، حتى لا يُعرض المصباحان الطرفيان مرتين متتاليتين.

غيّر BAR_MS إلى 300 واضغط «تشغيل» لإبطاء العمود، أو غيّر 8 في الحلقة الأولى إلى 4 فيصل العمود إلى المنتصف فقط. الحلقات تتولى العدّ؛ أنت تغيّر الحدود فقط.

firmware/uno/examples/chaser (الدالة loop() المشغّلة أعلاه)
void loop() {
  // the bar fills from the left, then empties
  for (int n = 1; n <= 8; n++) {
    show((uint8_t)((1u << n) - 1u));
    delay(BAR_MS);
  }
  for (int n = 7; n >= 0; n--) {
    show((uint8_t)((1u << n) - 1u));
    delay(BAR_MS);
  }
  // then a single dot runs to the right and back
  for (int n = 0; n < 8; n++) {
    show((uint8_t)(1u << n));
    delay(DOT_MS);
  }
  for (int n = 6; n >= 1; n--) {
    show((uint8_t)(1u << n));
    delay(DOT_MS);
  }
}

العدّ التنازلي، وبالخطوات، وحلقة داخل حلقة

يمكن أن تكون الأجزاء الثلاثة أي شيء. for (int i = 10; i > 0; i -= 3) تبدأ من 10، وتنقص ثلاثة في كل مرة، وقد طبَعت "10 7 4 1". لا يلزم أن تهبط الخطوة على الحد بالضبط؛ الحلقة تتوقف فقط عندما يفشل الشرط.

ضع حلقة داخل أخرى، فتعمل الداخلية كاملة في كل دورة من الخارجية. الكود أدناه طبَع جدول ضرب، "1 2 3" ثم "2 4 6" ثم "3 6 9"، صف واحد لكل دورة من row. هكذا تفحص لوحة أرقام، أو تضيء مصفوفة LED، أو تمرّ على شبكة من أي شيء.

حلقة داخل حلقة
void setup() {
  Serial.begin(9600);
  for (int row = 1; row <= 3; row++) {
    for (int col = 1; col <= 3; col++) {
      Serial.print(row * col);
      Serial.print(' ');
    }
    Serial.println();
  }
}

void loop() {
}

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

break وcontinue

continue تتخطى بقية هذه الدورة وتنتقل مباشرة إلى التالية. break تخرج من الحلقة تمامًا. في الكود أدناه، تم تخطي 2 وانتهت الحلقة عندما بلغ i القيمة 5، فمن عشر دورات طبعت "0 1 3 4". break هي الطريقة المعتادة للخروج من البحث: مرّ على الحساسات، وتوقف عند أول واحد يتجاوز الحد.

تخطَّ واحدة، وتوقف مبكرًا
void setup() {
  Serial.begin(9600);
  for (int i = 0; i < 10; i++) {
    if (i == 2) continue;
    if (i == 5) break;
    Serial.print(i);
    Serial.print(' ');
  }
  Serial.println();
}

void loop() {
}

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

ثلاثة أخطاء، ارتُكبت عمدًا

واحدة زائدة. for (int i = 0; i <= 8; i++) تبدو ثماني دورات وهي تسع: عدَنا الدورات وطبَعت اللوحة 9. مع ثمانية LED مرقّمة من 0 إلى 7، تبحث الدورة التاسعة عن مصباح غير موجود. ابدأ العدّ من 0 واستخدم < مع عدد الأشياء، تصحّ الحلقة.

حلقة لا تنتهي أبدًا. النوع byte يحمل من 0 إلى 255، لذا for (byte i = 250; i < 256; i++) لا يمكن أن يفشل اختبارها أبدًا: بعد 255، يعود i++ إلى 0. طبَعت اللوحة من 250 إلى 255 ثم 0 و1 و2 وواصلت. وقد حذّرت لوحة البناء: result of comparison of constant 256 with expression of type 'byte' (aka 'unsigned char') is always true. استخدم int للعدّاد إلا إن كان لديك سبب لغير ذلك.

حلقة توقف العالم كله. حلقة for مع تأخير داخلها تعطّل كل شيء آخر حتى تنتهي. خمس دورات من delay(100) استغرقت نصف ثانية، 499 ms بحسب ساعة اللوحة نفسها، وخلال تلك النصف ثانية لم يستطع الكود قراءة زر أو تحديث أي شيء. لتحريك قصير لا بأس بذلك. أما لكود يجب أن يظل يستمع، فدع loop() نفسها تكون الحلقة وعُدّ الخطوات باستخدام millis()، كما توضح صفحة الوميض بدون تأخير.

افتح هذه الدائرة في المحرر. Arduino Uno: دائرة LED متتابعة على 74HC595، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.

افتح الدائرة

الأسئلة

ما الفرق بين loop() وحلقة for؟

loop() هي الدالة التي يشغّلها الـ Arduino مرارًا وتكرارًا إلى الأبد بعد setup(). أما حلقة for فهي أمر داخل كودك يشغّل كتلته عددًا محددًا من المرات ثم يترك الكود يكمل. معظم الأكواد تحتوي حلقات for داخل loop().

لماذا تعمل حلقة for مرة واحدة زيادة؟

عادةً ما يحتوي الشرط على <= حيث يجب أن يحتوي على <. حلقة for (int i = 0; i <= 8; i++) تعمل تسع مرات، بقيم i من 0 إلى 8. عند العد من 0، يكون الشرط لثماني دورات هو i < 8.

لماذا تصبح حلقة for لا نهائية؟

إما أن العدّاد لا يتغير أبدًا، أو أن نوعه لا يستطيع بلوغ الحد. عدّاد من نوع byte مع i < 256 يلتف من 255 إلى 0 إلى الأبد، ويحذّرك المترجم من أن المقارنة صحيحة دائمًا. استخدم int.

كيف أخرج من حلقة for مبكرًا؟

استخدم break. تخرج من الحلقة فورًا ويكمل الكود بعد القوس المغلق. وcontinue هي قرينتها: تتخطى بقية الدورة وتنتقل إلى التالية.

هل يمكنني استخدام حلقة for لتعتيم LED تدريجيًا؟

نعم. حلقة for (int b = 0; b <= 255; b++) { analogWrite(9, b); delay(5); } ترفع سطوع LED على الطرف 9 تدريجيًا في نحو 1.3 ثانية. صفحة تلاشي PWM فيها الكود الكامل، وكيفية فعل ذلك بدون حجب البرنامج.

المصادر

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

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

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