عرض مصدر Arduino/time/delay

<noinclude>{{DISPLAYTITLE:الدالة <code>delay()‎</code> في  أردوينو}}</noinclude>
توقف الدالة <code>delay()‎</code> تنفيذ البرنامج مؤقتًا لفترة محدَّدة من الزمن (بالميلي ثانية).

==البنية العامة==
<syntaxhighlight lang="arduino">
delay(ms)
</syntaxhighlight>
==المعاملات==
===<code>ms</code>===
[[Arduino/long|عددٌ طويلٌ عديم الإشارة]] (unsigned long) يمثِّل الزمن في الميلي ثانية المراد إيقاف تنفيذ البرنامج مؤقتًا خلاله.

'''تذكير''': يوجد 1,000 ميلي ثانية في الثانية الواحدة.

==القيم المعادة==
لا يعاد أي شيء.

== أمثلة ==
استعمال الدالة <code>delay()‎</code> لإيقاف البرنامج مؤقتًا عن العمل لمدة ثانية واحدة قبل قلب حالة رجل الخرج المتصلة بضوء ليد:<syntaxhighlight lang="arduino">
int ledPin = 13;                 // ضوء ليد متصل بالرجل 13

void setup()
{
  pinMode(ledPin, OUTPUT);      // على أنَّها رجل خرج ledPin تهيئة الرجل 
}

void loop()
{
  digitalWrite(ledPin, HIGH);   // تشغيل الضوء
  delay(1000);                  // الانتظار لمدة ثانية واحدة
  digitalWrite(ledPin, LOW);    // إطفاء الضوء
  delay(1000);                  // الانتظار لمدة ثانية واحدة
}
</syntaxhighlight>
==ملاحظات وتحذيرات==
رغم أنَّه من السهل جدًا إنشاء ضوء ليد مومض مع الدالة <code>delay()‎</code> كما أنَّ الكثير من الشيفرات تستعمل هذه الدالة لخلق تأخيرات زمنية تتطلبها بعض المهام -مثل استعمالها لتلافي مشكلة ارتداد الزر عند ضغطه (button debouncing)- إلا أنَّ استعمال الدالة <code>delay()‎</code> في الشيفرة يرافقه الكثير من المساوئ. ففي أثناء تنفيذ عملية التأخير عند استدعاء الدالة، لن تٌقرَأ قيم الحساسات، ولن تُجرَى العمليات الحسابية، ولن تُعدَّل حالة أي رجل أو يُتحكَّم بها ...إلخ.، لذا فإنَّ استدعاء هذه الدالة يؤدي إلى مقاطعة بقية المهام والعمليات وإيقافها فترةً من الزمن. بدلًا من ذلك، اطلع على الدالة <code>[[Arduino/time/millis|millis()‎]]</code> والمثال المذكور في الأسفل للتعامل مع التأخيرات الزمنية والتحكم بالتوقيت بطريقة فعَّالة. يتجنب المبرمجون ذوو الخبرة والمعرفة عادةً استعمال الدالة <code>delay()‎</code> لتأخير الأحداث والتحكم بتوقيتها عندما تزيد فترة التأخير عن بضعة عشرات من الميلي ثانية سوى إذا كانت الشيفرة المكتوبة بسيطة جدًا.

هنالك بعض الأشياء تستمر في العمل خلال تحكم الدالة <code>delay()‎</code> بالمتحكم Atmega مثل المقاطعات، إذ لا تعطِّل هذه الدالة عملها. يُسجَّل أيضًا الاتصال التسلسلي المستقبل من الرجل RX، ويُحافَظ على القيم PWM (المكتوبة باستعمال <code>[[Arduino/analog io/analogwrite|analogWrite()‎]]</code>) وحالة الأرجل، وتستمر المقاطعات بالعمل بالشكل الذي يحلو لها.
==انظر أيضًا==
* الدالة <code>[[Arduino/time/delaymicroseconds|delayMicroseconds()‎]]</code>: توقف تنفيذ البرنامج مؤقتًا لفترة محدَّدة من الزمن (بالميكرو ثانية).
* الدالة <code>[[Arduino/time/micros|micros()‎]]</code>: تعيد زمن تشغيل لوحة أردوينو للبرنامج الحالي بالميكروثانية.
* الدالة <code>[[Arduino/time/millis|millis()‎]]</code>: تعيد زمن تشغيل لوحة أردوينو للبرنامج الحالي بالميلي ثانية.

*مثال عملي: جعل ضوء ليد يومض دون تأخير زمني.
==مصادر==
*[https://www.arduino.cc/reference/en/language/functions/time/delay/ صفحة الدالة delay()‎ في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Function]]
[[تصنيف: Arduino Time]]