دوال Arduino: اكتبها مرة، واستدعِها في أي مكان
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
الدالة كتلة كود معرّفة باسم يمكنك تشغيلها من أي مكان في كودك بكتابة اسمها. الدالة void flash(int pin, int times) تجعل أي طرف يومض أي عدد من المرات، فبدلًا من نسخ الأسطر الأربعة نفسها لكل LED، تكتب flash(13, 1) و flash(12, 2) و flash(11, 3). والدالتان setup() و loop() دالتان أيضًا؛ أنت تكتبهما طوال الوقت.
الدائرة أعلاه فيها ثلاثة مصابيح على الأطراف 13 و12 و11، تشغّلها هذه الدالة بالضبط. اضغط «تشغيل». ستطبع الشاشة التسلسلية "three lamps, one flash function"، ثم "pin 13 flashes 1 times" و"pin 12 flashes 2 times" و"pin 11 flashes 3 times"، وكل مصباح يفعل ما يقوله سطره.
في الأسفل شكل الدالة، والدوال التي تعيد إجابة، ولماذا لا يؤثر تغيير المعامل على المُستدعي، وأين يمكن للدوال أن تكون وأين لا يمكن، ورسائل الخطأ لكل خطأ.
تريد النسخة خطوة بخطوة؟ الدرس «اكتبها مرة» يشرح ذلك بنقاط تحقق.
افتح الدرسشكل الدالة
الدالة لها نوع إرجاع، واسم، ومعاملاتها بين قوسين، ثم جسمها بين حاصرات. في void flash(int pin, int times, int onMs)، يقول void إنها لا تعيد شيئًا، و flash هو الاسم، والأعداد الثلاثة int هي الأرقام التي يجب أن يعطيها المُستدعي. وداخلها، pin و times و onMs متغيرات عادية تحمل ما مرّره المُستدعي.
الدالتان الصغيرتان بعدها تجيبان عن سؤال بدل أن تنجزا مهمة. lampFor(round) تعيد الطرف الخاص بجولة، و timesFor(round) تعيد عدد الومضات، و loop() تستخدم إجابتيهما. غيّر return round + 1; إلى return round + 2; وسوف يومض كل مصباح مرة إضافية.
void flash(int pin, int times, int onMs) {
for (int i = 0; i < times; i++) {
digitalWrite(pin, HIGH);
delay(onMs);
digitalWrite(pin, LOW);
delay(onMs);
}
}
int lampFor(int round) {
if (round == 0) return LAMP_A;
if (round == 1) return LAMP_B;
return LAMP_C;
}
int timesFor(int round) {
return round + 1;
}إرجاع قيمة
أي نوع غير void يعني أن الدالة تعيد قيمة من ذلك النوع، و return هي الطريقة. يستطيع المُستدعي طباعتها أو تخزينها أو استخدامها في عملية جمع. في الأسفل، طبع twice(21) النتيجة 42.
لاحظ أن twice() مكتوبة بعد setup() التي تستدعيها. في لغة C++ العادية هذا خطأ، لأن المترجم يقرأ من الأعلى ولم يرَ twice بعد. أما Arduino IDE فيضيف بصمت تصريحًا لكل دالة في ملف .ino في الأعلى قبل الترجمة، وMokxi يفعل الشيء نفسه، لذا لا يهم الترتيب في كودك.
void setup() {
Serial.begin(9600);
Serial.println(twice(21));
}
void loop() {
}
int twice(int x) {
return x * 2;
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
المعاملات نسخ
المعامل نسخة مما مرّره المُستدعي. الدالة addOne(score) في الأسفل تضيف واحدًا إلى نسختها ثم ترميها، لذا ظل score يطبع 5 بعدها. في معظم الأحيان هذا بالضبط ما تريده: الدالة لا تستطيع تغيير متغيراتك خفيةً.
وحين تريد ذلك، ضع & بعد النوع. الدالة void addOneRef(int &n) تستقبل مرجعًا، وهو متغيّر المُستدعي نفسه باسم آخر، وبعد addOneRef(score) طُبع 6. والمرجع أيضًا هو الطريقة المعتادة للحصول على إجابتين من دالة واحدة: minMax(7, 3, lo, hi) ملأ الاثنين وطبعت "3 7".
void addOne(int n) {
n = n + 1;
}
void addOneRef(int &n) {
n = n + 1;
}
void setup() {
Serial.begin(9600);
int score = 5;
addOne(score);
Serial.println(score);
addOneRef(score);
Serial.println(score);
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
أين توضع الدوال، والأخطاء عند عدم ذلك
توضع الدالة خارج كل الدوال الأخرى، في المستوى الأعلى من الملف، عادة بعد loop() أو فوق setup(). أبقِ كل دالة قصيرة وامنحها اسمًا يقول ما تفعله، مثل readTemperature() أو flashError()، وسيبدأ loop() كأنه قائمة خطوات. اكتب دالة داخل setup() ويتوقف البناء. يترجم Mokxi بمترجم clang، وكلماته هي function definition is not allowed here؛ أما GCC في Arduino IDE فيقول a function-definition is not allowed here before '{' token. وهذا يعني دائمًا تقريبًا أن حاصرة إغلاق ناقصة في الأعلى، فيظن المترجم أنك ما زلت داخل setup(). عُدّ حاصراتك.
الدالة التي تَعِد بقيمة يجب أن تعيد قيمة في كل مسار. الدالة int f(int x) { if (x > 0) return 1; } تُبنى، مع تحذير: non-void function does not return a value in all control paths. استدعِ f(-5) فتحصل على ما تُرك بالمصادفة، وطبع هنا 1. أضف return في النهاية، حتى لو كانت return 0;.
الدوال الموجودة في تبويب .cpp منفصل لا تحصل على التعريفات التلقائية التي يحصل عليها ملف .ino. نقلنا دالة إلى تبويب اسمه more.cpp فتوقف الكود مع خطأ use of undeclared identifier 'helper'. ضع تعريفًا، void helper();، في ملف ترويسة مثل more.h وضع #include "more.h" في أعلى الكود، وسيعمل البناء.
افتح هذه الدائرة في المحرر. Arduino Uno: ثلاث مصابيح ودالة وميض واحدة، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة ثم اضغط «تشغيل» مرة أخرى.
الأسئلة
ماذا تعني void في Arduino؟
أن الدالة لا تعيد شيئًا. الدالتان void setup() و void loop() تنفّذان مهمة ولا تعيدان أي قيمة. أما الدالة التي تجيب عن سؤال فلها نوع بدلًا من ذلك، مثل int أو float، وتنتهي بـ return.
هل يجب أن أعرّف الدالة قبل استخدامها في Arduino؟
ليس في ملف .ino: بيئة Arduino IDE تضيف التعريفات نيابة عنك قبل الترجمة، وMokxi يفعل ذلك أيضًا، لذا يمكن كتابة الدالة أسفل الكود الذي يستدعيها. أما في ملف .cpp فيجب ذلك، عادة في ملف ترويسة.
كيف أعيد قيمتين من دالة؟
مرّر متغيرين بالمرجع، بوضع & بعد النوع، واضبطهما داخل الدالة. أو أعِد بنية (struct) تحتوي على الاثنين. مثال minMax() في هذه الصفحة يملأ قيمة دنيا وأخرى عليا بهذه الطريقة.
لماذا لا يغيّر تعديل المعامل متغيري؟
لأن المعامل نسخة. تعديله يغيّر النسخة فقط. عرّف المعامل كمرجع، int &n بدلًا من int n، إذا كان مقصودًا من الدالة أن تغيّر متغير المستدعي.
ماذا يعني خطأ "a function-definition is not allowed here"؟
أن دالة تُعرَّف داخل دالة أخرى، وفي الأغلب لأن قوس إغلاق مفقود فوقها. ابحث عن الدالة التي قبل الخطأ وتأكد أن كل { له }.
هل يمكن لدالة في Arduino أن تعيد مصفوفة؟
ليس كمصفوفة. يمكن للدالة أن تعيد مؤشرًا، لكن إعادة عنوان مصفوفة محلية خطأ برمجي: يكتمل البناء مع تحذير address of stack memory associated with local variable 'a' returned، لأن المصفوفة تختفي بمجرد انتهاء الدالة. مرّر المصفوفة كمعامل واملأها، أو أعِد بنية (struct) تحمل القيم.
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.