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

<noinclude>{{DISPLAYTITLE:الدالة <code>millis()‎</code> في  أردوينو}}</noinclude>
تعيد الدالة <code>millis()‎</code> زمن تشغيل لوحة أردوينو للبرنامج الحالي بالميلي ثانية.

ستصل القيمة التي تحسبها هذه الدالة إلى حالة الطفحان (أي ستعود إلى الصفر) بعد مرور 50 يومٍ تقريبًا.

==البنية العامة==
<syntaxhighlight lang="arduino">
time = millis()
</syntaxhighlight>
==القيم المعادة==
يعاد [[Arduino/long|عدد طويل عديم الإشارة]] (unsigned long) يمثِّل زمن بدء تشغيل لوحة أردوينو للبرنامج الحالي إلى لحظة استدعاء الدالة <code>millis()‎</code> بالميلي ثانية.

== أمثلة ==
استعمال الدالة <code>millis()‎</code> لمعرفة منذ متى بدأت لوحة أردوينو بالعمل:<syntaxhighlight lang="arduino">
unsigned long time;

void setup(){
  Serial.begin(9600);
}
void loop(){
  Serial.print("Time: ");
  time = millis();

  Serial.println(time);  // طباعة المدة الزمنية التي استغرقها البرنامج منذ أن بدأ بالعمل 
  delay(1000);           // الانتظار لمدة ثانية واحدة لكي لا تُرسَل كمية هائلة من البيانات 
}
</syntaxhighlight>
==ملاحظات وتحذيرات==
انتبه رجاءً إلى أنَّ نوع القيمة التي تعيدها الدالة <code>millis()‎</code> هي [[Arduino/long|عددٌ طويلٌ عديم الإشارة]] (unsigned long)، لذا قد تحصل أخطاء منطقية إن حاول المبرمج إجراء عمليات حسابية مع أنواع أصغر من الأعداد، مثل [[Arduino/int|الأعداد الصحيحة]] (int). حتى إجراء عمليات حسابية مع [[Arduino/long|عدد طويل ذي إشارة]] (signed long) قد تؤدي إلى حصول أخطاءٍ لأنَّ سعته القصوى هي نصف سعة العدد عديم الإشارة المقابل له.
==انظر أيضًا==
* الدالة <code>[[Arduino/time/delay|delay()‎]]</code>: توقف تنفيذ البرنامج مؤقتًا لفترة محدَّدة من الزمن (بالميلي ثانية).
* الدالة <code>[[Arduino/time/delaymicroseconds|delayMicroseconds()‎]]</code>: توقف تنفيذ البرنامج مؤقتًا لفترة محدَّدة من الزمن (بالميكرو ثانية).
* الدالة <code>[[Arduino/time/micros|micros()‎]]</code>: تعيد زمن تشغيل لوحة أردوينو للبرنامج الحالي بالميكروثانية.

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