الفرق بين المراجعتين لصفحة: «Arduino/singlelinecomment»
جميل-بيلوني (نقاش | مساهمات) إضافة محتويات الصفحة. |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 16: | سطر 16: | ||
digitalWrite(led, HIGH); // | digitalWrite(led, HIGH); // شغل الضوء المتصل بالرجل 13 (القيمة | ||
// .(هي مستوى الفولط HIGH | |||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 26: | سطر 27: | ||
*التعبير <code>[[Arduino/define|#define]]</code>: هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج. | *التعبير <code>[[Arduino/define|#define]]</code>: هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج. | ||
*الرمز <code>[[Arduino/semicolon|;]]</code>: يُستعمَل لإنهاء كل تعبير برمجي في لغة أردوينو C. | *الرمز <code>[[Arduino/semicolon|;]]</code>: يُستعمَل لإنهاء كل تعبير برمجي في لغة أردوينو C. | ||
* | * الأقواس <code>[[Arduino/curlybraces|{}]]</code>: هي جزء لا يتجزأ من لغة C وتستعمل في بُنى عديدة مثل بنى التحكم وغيرها. | ||
*[[Arduino/blockcomment|استعمال التعليقات الكتلية في أردوينو.]] | *[[Arduino/blockcomment|استعمال التعليقات الكتلية في أردوينو.]] | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 07:33، 7 نوفمبر 2018
التعليقات هي أسطر توضع في الشيفرة ولا تُنفَّذ بهدف توضيح كيفية عمل البرنامج سواءً لك أو لغيرك. تُهمل هذه الأسطر أينما وُجدَت أثناء تفسير الشيفرة ولا تدخل ضمن البرنامج التنفيذي الذي يُرسَل إلى المتحكم ويُكتَب في ذاكرته. هذا يعني أنها لا تأخذ أية مساحة من ذاكرة البرنامج (الذاكرة flash) في المتحكم. الهدف الوحيد من استعمال التعليقات هو شرح كيفية عمل البرنامج للمساعدة على فهمه وتذكره عندما تطَّلع أنت أو غيرك على شيفرته بعد فترة من الزمن.
تبدأ التعليقات السطرية بخطين مائلين متجاورين // وتنتهي بنهاية السطر بشكل تلقائي. سيُتجاهل أي شيء يلي الرمزين // حتى نهاية السطر أثناء تفسير الشيفرة.
البنية العامة
// تعليق سطري
أمثلة
هنالك طريقتان لإضافة تعليقات سطرية:
// يتصل بالرجل 13 ضوء ليد في أغلب لوحات أردوينو.
// أعطِ الرجل 13 اسمًا:
int led = 13;
digitalWrite(led, HIGH); // شغل الضوء المتصل بالرجل 13 (القيمة
// .(هي مستوى الفولط HIGH
ملاحظات وتحذيرات
أثناء تجريب الشيفرة واختبار عملها، يكون تعليق جزء من الشيفرة هو طريقة ملائمة لحذف الأسطر التي يُشَك بأنَّ الخطأ واقعٌ ضمنها. تعليق الأسطر لا يؤدي إلى حذفها بالمعنى الحرفي من الشيفرة بل الإبقاء عليها في الشيفرة وحذفها من الملف التنفيذي المرسل إلى المتحكم أثناء تفسيرها. هذا الأمر مفيد جدًا ويساعد على تنقيح الشيفرة من الأخطاء وتحصيل مكان الخطأ خصوصًا عندما يرفض المفسِّر تفسير الشيفرة ويرمي خطأَ غير معروف أو مبهم.
انظر أيضًا
- التعبير
#include: يُستعمَل لتضمين مكتبات خارجية في شيفرتك. - التعبير
#define: هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج. - الرمز
;: يُستعمَل لإنهاء كل تعبير برمجي في لغة أردوينو C. - الأقواس
{}: هي جزء لا يتجزأ من لغة C وتستعمل في بُنى عديدة مثل بنى التحكم وغيرها. - استعمال التعليقات الكتلية في أردوينو.