تعلّم

‏const و#define في Arduino: طريقتان لإعطاء رقم اسمًا

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
‏Arduino Uno: طرف واحد باسم، وميضمباشر0.000 s 0.00x
اضغط «تشغيل»، ثم غيّر LAMP إلى 12
const int LAMP = 13; names the pin once. Change it to 12 and the yellow lamp blinks instead.

كلاهما يعطي الرقم اسمًا، فتستطيع كتابة LAMP بدلًا من 13 وتغييره في مكان واحد. const int LAMP = 13; ينشئ متغيرًا بنوع لا يمكن أن يتغير أبدًا. #define LAMP 13 يطلب من المترجم أن يجد كل LAMP في الكود ويضع 13 مكانه قبل أن يترجم أي شيء. لأرقام الأطراف والإعدادات، استخدم const: مرجع Arduino يوصي به، ويتجنب كل الأخطاء أدناه.

الدائرة أعلاه هي منضدة الكود: لوحة Uno مع ثلاثة مصابيح. اضغط «تشغيل». يومض المصباح الأحمر على الطرف 13، وتطبع الشاشة التسلسلية "hello from the board" ثم "setup() has run once" ثم "loop() pass 1" و"loop() pass 2" وهكذا. الطرف مسمّى مرة واحدة، في الأعلى، بالسطر const int LAMP = 13;. غيّر 13 إلى 12 واضغط «تشغيل»، فيومض الطرف 12، المصباح الأصفر، بدلًا منه.

فيما يلي ما يفعله #define، ولماذا LED_BUILTIN هو أحدها، والطرائق الخمس التي يخطئ فيها #define حيث لا يخطئ const، كل واحدة منها مبنية في Mokxi مع ما طبعته أو الخطأ الذي أظهرته.

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

افتح الدرس

اسم لطرف

هذا هو الكود كاملًا الذي يعمل أعلاه. LAMP مستخدم ثلاث مرات ومعرّف مرة واحدة. من دون الاسم، كان تغيير الطرف يعني البحث عن كل 13 في الكود والأمل في أن أيا منها لا يعني شيئًا آخر.

const means the value is fixed. Try to change it, LAMP = 12; inside setup(), and the build stops: clang says cannot assign to variable 'LAMP' with const-qualified type 'const int', and the Arduino IDE’s GCC says assignment of read-only variable 'LAMP'. That is the point: a pin number that changes while the sketch runs is a bug.

‏firmware/uno/examples/cpphello (الكود الذي يعمل أعلاه)
const int LAMP = 13;

int passes = 0;

void setup() {
  pinMode(LAMP, OUTPUT);
  Serial.begin(115200);
  Serial.println("hello from the board");
  Serial.println("setup() has run once");
}

void loop() {
  passes = passes + 1;
  Serial.print("loop() pass ");
  Serial.println(passes);

  digitalWrite(LAMP, HIGH);
  delay(200);
  digitalWrite(LAMP, LOW);
  delay(800);
}

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

ما الذي يفعله #define حقًا

‏#define ليس متغيرًا. هو عملية بحث واستبدال تجري على نص الكود قبل أن يقرأه المترجم. #define LAMP 13 لا نوع له ولا يأخذ ذاكرة؛ كل LAMP بعده يصبح ببساطة 13.

أنت تستخدمها بالفعل. LED_BUILTIN هو #define LED_BUILTIN 13 في نواة Uno، وطباعته أعطت 13. HIGH هو #define للقيمة 1 وطبع 1. تُكتب هذه بالأحرف الكبيرة عرفًا، فالاسم المكتوب بالكامل بأحرف كبيرة يخبر القارئ أنه قد يكون #define، وconst يُكتب عادة بأحرف كبيرة أيضًا لأنه يؤدي المهمة نفسها.

الفاصلة المنقوطة وعلامة التساوي

سطر #define ليس تعليمة، فلا يحتاج فاصلة منقوطة ولا علامة تساوي. مع #define LED 13;، تُلصق الفاصلة المنقوطة مع الـ13، فيصبح pinMode(LED, OUTPUT); هو pinMode(13;, OUTPUT);. يقول clang ‏expected ')'، مع ملاحظة تشير إلى #define، expanded from macro 'LED'؛ ويقول GCC ‏expected ')' before ';' token. الخطأ يظهر على السطر الذي يستخدم الاسم، لا على السطر الخاطئ، ولهذا يطول العثور عليه.

‏#define LED = 13 يفشل بالطريقة نفسها، فيصبح pinMode(= 13, OUTPUT)، ويقول clang ‏expected expression. أما const فلا يمكن أن يقع في أي من الخطأين: const int LED = 13; تعليمة عادية، بعلامة تساويها وفاصلتها المنقوطة في مكانهما الصحيح.

فاصلة منقوطة ملصوقة
#define LED 13;

void setup() {
  pinMode(LED, OUTPUT);
}

void loop() {
}

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

أقواس مفقودة

لأن #define يلصق نصًا، فالحساب الذي يلصقه يختلط بما حوله. مع #define WIDTH 10 + 5، يصبح WIDTH * 2 هو 10 + 5 * 2 وطبع 20، بينما const int WIDTH_C = 10 + 5; عند المضاعفة طبع 30. و#define الذي يأخذ قيمة أسوأ: #define SQUARE(x) x * x حوّل SQUARE(1 + 2) إلى 1 + 2 * 1 + 2 وطبع 5. وبوضع أقواس حول كل استخدام وحول الكل، ((x) * (x))، طبع 9.

‏#define أيضًا لا نوع له، فيجري حسابه في int. #define SECONDS 60 * 60 * 24 طبع 20864 ليوم كامل، مع تحذير تجاوز، بينما const long SECONDS_C = 60L * 60 * 24; طبع 86400. صفحة أنواع البيانات تشرح السبب.

حسابات ملصوقة
#define WIDTH 10 + 5
#define SQUARE(x) x * x
#define SQUARE_OK(x) ((x) * (x))
const int WIDTH_C = 10 + 5;

void setup() {
  Serial.begin(9600);
  Serial.println(WIDTH * 2);
  Serial.println(WIDTH_C * 2);
  Serial.println(SQUARE(1 + 2));
  Serial.println(SQUARE_OK(1 + 2));
  Serial.println(LED_BUILTIN);
  Serial.println(HIGH);
}

void loop() {
}

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

أسماء تتعارض

أمر ‎#define‎ يستبدل اسمه في كل مكان بعده، وفي كل دالة، دون أي استثناء. بعد ‎#define LED 13‎، يصبح سطر داخل ‎setup()‎ يقول ‎int LED = 5;‎ هو ‎int 13 = 5;‎، فيقول clang‏ expected unqualified-id. ويحدث الأمر نفسه مع الأسماء التي عرّفتها نواة Arduino مسبقًا. يبدو ‎const float PI = 3.14;‎ بريئًا لكنه أوقف البناء بالخطأ نفسه، لأن ‎PI‎ هو بالفعل ‎#define‎ في النواة، فأصبح السطر ‎const float 3.14159... = 3.14;‎.

عرّف الاسم نفسه مرتين فيفوز التعريف الثاني، مع تحذير فقط. #define LED 13 متبوعًا بـ#define LED 12 طبع 12، وقالت لوحة البناء 'LED' macro redefined. أما constان بالاسم نفسه في المكان نفسه فيوقفان البناء، وهذا هو الجواب الأكثر أمانًا.

ما الذي يبقى لـ#define

استخدم const للأرقام والأطراف والإعدادات، وconstexpr لقيمة تُحسب من قيم أخرى، كما في constexpr int LIMIT = COUNT * 2;، الذي طبع 6. وconst int يمكنه تحديد حجم مصفوفة أيضًا: int pins[COUNT] مع COUNT تساوي 3 قاس 6 بايت، ثلاثة أعداد int بحجم 2 بايت لكل منها.

‏#define هو الأداة المناسبة لتشغيل أجزاء من الكود وإيقافها قبل ترجمته. مع #define DEBUG في الأعلى، تُبنى الأسطر بين #ifdef DEBUG و#endif، وطبع كودنا "start" و"debug: setup done". احذف #define فيطبع الكود نفسه "start" فقط، ولم تُترجم أسطر التنقيح أصلًا.

أسطر تنقيح تأتي وتذهب
#define DEBUG

void setup() {
  Serial.begin(9600);
  Serial.println("start");
#ifdef DEBUG
  Serial.println("debug: setup done");
#endif
}

void loop() {
}

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

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

الأسئلة

هل أستخدم const أم #define في Arduino؟

استخدم const لأرقام الأطراف والإعدادات. له نوع، ويتبع القواعد المعتادة للأسماء، ولا يمكن أن يُلصق فيه فاصلة منقوطة أو عملية جمع زائدة. أبقِ #define لتشغيل الكود وإيقافه بواسطة #ifdef.

هل يستخدم #define ذاكرة على Arduino؟

لا. يتم استبداله قبل الترجمة، فلا يبقى في الكود سوى الرقم.

لماذا يسبب #define مع فاصلة منقوطة خطأً؟

لأن الفاصلة المنقوطة تُلصق مع القيمة. فالسطر ‎#define LED 13;‎ يحوّل ‎pinMode(LED, OUTPUT)‎ إلى ‎pinMode(13;, OUTPUT)‎، ويظهر الخطأ على ذلك السطر، لا على سطر #define.

ماذا يعني "expected unqualified-id" مع #define؟

اسم استخدمته هو في الأصل #define، فتم استبداله برقم في مكان كان المترجم يريد فيه اسمًا. تُعرّف Arduino أسماء مثل PI و HIGH و LOW و INPUT وغيرها؛ اختر اسمًا آخر.

ما الفرق بين const و constexpr؟

كلاهما ينشئ قيمة لا يمكن تغييرها. لكن constexpr يعد أيضًا المترجم بأنه يستطيع حسابها أثناء البناء، فيمكن استخدامه في أي مكان يلزم فيه رقم ثابت، مثل حجم مصفوفة.

ما الفرق بين const int و int؟

يمكن لـ int أن تتغير أثناء تشغيل الكود، بينما const int لا يمكن. اكتب `LAMP = 12;` بعد `const int LAMP = 13;` وسيتوقف البناء برسالة cannot assign to variable 'LAMP' with const-qualified type 'const int'، ويقول مترجم GCC في Arduino IDE‏: assignment of read-only variable 'LAMP'. هذا الخطأ هو المقصود: لا يمكن تغيير رقم طرف بالخطأ.

المصادر

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

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

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