تعلّم

خطأ Arduino "expected ';' before" وبقية أخطاء "expected" الأخرى

متوسط

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: إشارة مرور جاهزة للتعطيلمباشر0.000 s 0.00x
اضغط على الزر مع الاستمرار
إشارة مرور تعمل. افتحها، واحذف فاصلة منقوطة أو قوسًا، ثم اضغط «تشغيل» لترى أي خطأ "expected" ستحصل عليه.

كل خطأ "expected" يعني الشيء نفسه: كان المترجم يقرأ الكود، فقابل كلمة أو رمزًا لا يمكن أن يأتي بعده، وهو يخبرك بما كان ينتظره بدلاً منه. الرمز الذي بعد "before" هو الموضع الذي توقف عنده، وهو عادةً بعد الخطأ الحقيقي مباشرةً، لا فيه.

تتناول هذه الصفحة كل رسالة "متوقعة" يطبعها Arduino IDE، بصياغة GCC، مع ما يقوله clang، وهو المترجم الذي تستخدمه Mokxi، عن السطر نفسه، ومعه طريقة الإصلاح. الدائرة أعلاه إشارة مرور يحتوي كودها على الكثير من الفواصل المنقوطة والأقواس المعقوفة والمربعة التي يمكنك حذفها. افتحها، واحذف واحدة، واضغط «تشغيل»، واقرأ الخطأ.

"expected ';' before"

يسمّي GCC الرمز الذي يأتي بعد الفراغ. السطر pinMode(13, OUTPUT) بلا فاصلة منقوطة، متبوعًا بقوس إغلاق setup()، يعطي expected ';' before '}' token على سطر القوس. أما clang فيشير إلى الفراغ نفسه: expected ';' after expression، مع علامة إقحام بعد OUTPUT) مباشرة. في كلتا الحالتين، توضع الفاصلة المنقوطة في نهاية السطر الذي يسبق السطر الذي يسمّيه GCC.

خارج الدالة تتغيّر الصياغة. متغيّر شامل مثل int count = 0 بلا فاصلة منقوطة، متبوعًا بـ void setup()، يعطي expected ',' or ';' before 'void' من GCC و expected ';' after top level declarator من clang. والإصلاح نفسه.

الأسطر التي تفتح كتلة لا تأخذ فاصلة منقوطة: void setup() {، if (x > 5) {، for (...) {. الفاصلة المنقوطة هنا خطأ مختلف وأهدأ: if (x > 512); { تنهي الشرط عند الفاصلة المنقوطة، فتعمل الكتلة التي بعدها في كل مرة. تتم الترجمة دون أي كلمة في المترجمين، لذا إذا بدا أن شرطًا ما يُتجاهل، انظر إلى نهاية سطره.

فواصل منقوطة بعد التعليمات والتصريحات، ولا شيء منها بعد سطر يفتح كتلة
int count = 0;

void setup() {
  pinMode(13, OUTPUT);
  Serial.begin(9600);
}

void loop() {
  count = count + 1;
  if (count % 2 == 0) {
    digitalWrite(13, HIGH);
  } else {
    digitalWrite(13, LOW);
  }
  Serial.println(count);
  delay(500);
}

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

"expected ')' before"

قوس دائري فُتح ولم يُغلق. السطر if (analogRead(A0) > 512 { يفتح قوسين ويغلق واحدًا، فيقول GCC expected ')' before '{' token ويقول clang expected ')'، مع ملاحظة تشير إلى القوس الذي تعذّر إيجاد مقابله. عُدّ الأزواج من الداخل إلى الخارج: كل ( يحتاج إلى ) الخاص به قبل {.

حلقة for مكتوبة بفواصل عادية بدلًا من الفواصل المنقوطة، for (int i = 0, i < 3, i++)، هي قريبة من هذه. يقول clang expected ';' in 'for' statement specifier؛ أما صياغة GCC فتتوقف على إصداره. الأجزاء الثلاثة لحلقة for يفصل بينها فواصل منقوطة.

"expected primary-expression before"

شيء ما ناقص في منتصف تعبير. السطر if (x > ) { لا شيء بعده >، فيقول GCC expected primary-expression before ')' token ويقول clang expected expression. التعبير الأولي هو قيمة: رقم، أو متغيّر، أو نص، أو استدعاء دالة.

الرسالة نفسها تأتي من كتابة نوع حيث يجب أن تكون قيمة، كما في Serial.println(int);، أو من تمرير مصفوفة بأقواسها، sum(values[])، بينما الاستدعاء يريد sum(values) فقط.

"expected initializer before"

تصريح يتوقف في منتصفه. السطر int count 0; يُغفل =، فيقول GCC expected initializer before numeric constant، ويقول clang expected ';' after top level declarator، مشيرًا إلى ما بعد count مباشرة. أعِد = بين الاسم والقيمة.

يقول GCC الشيء نفسه، بكلمة مختلفة بعد "before"، عندما يوجد في السطر الأول من دالة كلمة زائدة. في void blink(int times) fast { يتوقع المترجم قوس الدالة الافتتاحي مباشرة بعد قوس الإغلاق، فيبلغ GCC عن expected initializer before 'fast' ويبلغ clang عن expected function body after function declarator. اقرأ السطر من اليسار: نوع، ثم اسم، ثم القوسان مع المعاملات، ثم القوس المعقوص.

"expected unqualified-id" و "expected declaration before '}'"

تأتي هذه من كود انتهى به الحال خارج كل دالة، غالبًا لأن قوسًا أغلق دالة قبل موعده. قوس } إضافي في نهاية loop() يجعل } التالي بلا شيء يغلقه: يقول GCC expected declaration before '}' token، ويقول clang extraneous closing brace ('}').

إذا كان القوس الزائد في منتصف loop()، فإن الأسطر التي بعدها تصبح خارج كل دالة، ووجود if أو for هناك يعطي رسالة GCC expected unqualified-id before 'if' (clang: expected unqualified-id). ابحث عن القوس الذي يغلق الدالة مبكرًا. ميزة Auto Format، أي Ctrl+T في Arduino IDE، تُبرزه بسحب بقية الدالة إلى الهامش الأيسر.

"stray '\342' in program"

هذه ليست علامة ترقيم نسيتها بل علامة ترقيم لصقتها. الكود المنسوخ من صفحة ويب أو ملف PDF أو معالج نصوص قد يجلب علامات اقتباس منحنية (“ ” ‘ ’)، أو شرطة طويلة مكان علامة الطرح، أو مسافة غير فاصلة غير مرئية. يبلغ GCC عن كل بايت من هذه المحارف على حدة، كـ stray '\342' in program و stray '\200' in program وهكذا، عدة مرات في السطر الواحد. أما clang فيسمّي المحرف: unexpected character <U+201C>.

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

افتح هذه الدائرة في المحرر. Arduino Uno: إشارة مرور، جاهزة للإفساد، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها من جديد.

افتح الدائرة

الأسئلة

ماذا تعني "expected ';' before" في Arduino؟

جملة تنقصها فاصلتها المنقوطة. الرمز الذي يأتي بعد "before" هو بداية الجملة التالية، فتوضع الفاصلة المنقوطة في نهاية السطر الذي قبله.

ماذا تعني "stray '\342' in program"؟

كودك يحتوي على محرف من خارج النص العادي، وهو في الغالب علامة اقتباس منحنية أو شرطة طويلة أو مسافة غير قابلة للكسر نُسخت من صفحة ويب أو مستند. أعد كتابة علامات الاقتباس والشرطات في ذلك السطر.

ما هو primary-expression؟

قيمة يستطيع المترجم استخدامها بمفردها: رقم، أو اسم متغير، أو نص، أو استدعاء دالة. عبارة "expected primary-expression" تعني أن واحدة منها تنقص حيث احتاجها مُعامل أو قوس.

هل يعرض Mokxi نفس أخطاء Arduino IDE؟

الأخطاء نفسها، بكلمات مختلفة. يستخدم Arduino IDE برنامج GCC بينما يستخدم Mokxi برنامج clang؛ وتعطيك هذه الصفحة كليهما لتتمكن من البحث عن أيٍّ منهما.

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

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