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

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

ستصل القيمة التي تحسبها هذه الدالة إلى حالة الطفحان (أي سيعود إلى الصفر) بعد مرور 70 دقيقة تقريبًا. في لوحات أردوينو التي تعمل بتردد 16 ميغاهرتز (مثل لوحات Duemilanove، و Nano)، تكون دقة هذه الدالة هي 4 ميكروثانية (أي القيمة التي تعيدها الدالة هي من مضاعفات العدد 4 دومًا). أمَّا في لوحات أردوينو التي تعمل بتردد 8 ميغاهرتز (مثل لوحات LilyPad)، تكون دقة هذه الدالة هي 8 ميكروثانية.

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

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

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

  Serial.println(time);  // طباعة المدة الزمنية التي استغرقها البرنامج منذ أن بدأ بالعمل 
  delay(1000);           // الانتظار لمدة ثانية واحدة لكي لا تُرسَل كمية هائلة من البيانات 
}
</syntaxhighlight>
==ملاحظات وتحذيرات==
'''تذكير''': يوجد 1,000 ميكروثانية في كل ميلي ثانية واحدة، ويوجد 1,000,000 ميكروثانية في كل ثانية واحدة.
==انظر أيضًا==
* الدالة <code>[[Arduino/time/delay|delay()‎]]</code>: توقف تنفيذ البرنامج مؤقتًا لفترة محدَّدة من الزمن (بالميلي ثانية).
* الدالة <code>[[Arduino/time/delaymicroseconds|delayMicroseconds()‎]]</code>: توقف تنفيذ البرنامج مؤقتًا لفترة محدَّدة من الزمن (بالميكرو ثانية).
* الدالة <code>[[Arduino/time/millis|millis()‎]]</code>: تعيد زمن تشغيل لوحة أردوينو للبرنامج الحالي بالميلي ثانية.

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