الفرق بين المراجعتين لصفحة: «Arduino/blockcomment»
< Arduino
جميل-بيلوني (نقاش | مساهمات) أنشأ الصفحة ب'التعليقات هي أسطر توضع في الشيفرة ولا تُنفَّذ بهدف توضيح كيفية عمل البرنامج سواءً لك أو لغير...' |
جميل-بيلوني (نقاش | مساهمات) إضافة محتويات الصفحة. |
||
| سطر 1: | سطر 1: | ||
التعليقات هي أسطر توضع في الشيفرة ولا تُنفَّذ بهدف توضيح كيفية عمل البرنامج سواءً لك أو لغيرك. تُهمل هذه الأسطر أينما وُجدَت أثناء تفسير الشيفرة ولا تدخل ضمن البرنامج التنفيذي الذي يُرسَل إلى المتحكم ويُكتَب في ذاكرته. هذا يعني | <noinclude>{{DISPLAYTITLE:التعليقات متعددة الأسطر في أردوينو}}</noinclude> | ||
التعليقات هي أسطر توضع في الشيفرة ولا تُنفَّذ بهدف توضيح كيفية عمل البرنامج سواءً لك أو لغيرك. تُهمل هذه الأسطر أينما وُجدَت أثناء تفسير الشيفرة ولا تدخل ضمن البرنامج التنفيذي الذي يُرسَل إلى المتحكم ويُكتَب في ذاكرته. هذا يعني أنَّها لا تأخذ أية مساحة من ذاكرة البرنامج (الذاكرة flash) في المتحكم. الهدف الوحيد من استعمال التعليقات هو شرح كيفيَّة عمل البرنامج للمساعدة على فهمه وتذكره عندما تطَّلع أنت أو غيرك على شيفرته بعد فترة من الزمن. | |||
تبدأ التعليقات الكتلية (block comment) أو | تبدأ التعليقات الكتلية (block comment) أو التعليقات متعددة الأسطر (multi-line comment) بالرمز <code>*/</code> وتنتهي بالرمز <code>/*</code>. يمكن أن يمتد هذا التعليق على عدَّة أسطر بحسب الحاجة؛ ومتى ما قرأ المفسِّر الرمز <code>*/</code>، سيتجاهل كل ما كُتِب بعده حتى يصل إلى الرمز <code>/*</code>. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 17: | سطر 18: | ||
== أمثلة == | == أمثلة == | ||
يوضح المثال التالي كيفية استعمال التعليقات | يوضح المثال التالي كيفية استعمال التعليقات متعددة الأسطر مع التعليقات السطرية:<syntaxhighlight lang="arduino"> | ||
/* هذا تعليق كتلي في سطر واحد */ | /* هذا تعليق كتلي في سطر واحد */ | ||
| سطر 38: | سطر 39: | ||
== ملاحظات وتحذيرات == | == ملاحظات وتحذيرات == | ||
أثناء تجريب الشيفرة واختبار عملها، يكون تعليق جزء من الشيفرة هو طريقة ملائمة لحذف الأسطر التي يُشَك بأنَّ الخطأ واقعٌ ضمنها. تعليق الأسطر لا يؤدي إلى حذفها بالمعنى الحرفي من الشيفرة بل الإبقاء عليها في الشيفرة وحذفها من | أثناء تجريب الشيفرة واختبار عملها، يكون تعليق جزء من الشيفرة هو طريقة ملائمة لحذف الأسطر التي يُشَك بأنَّ الخطأ واقعٌ ضمنها. تعليق الأسطر لا يؤدي إلى حذفها بالمعنى الحرفي من الشيفرة بل الإبقاء عليها في الشيفرة وحذفها من الملف التنفيذي المرسل إلى المتحكم أثناء تفسيرها. هذا الأمر مفيد جدًا ويساعد على تنقيح الشيفرة من الأخطاء وتحصيل مكان الخطأ خصوصًا عندما يرفض المفسِّر تفسير الشيفرة ويرمي خطأَ غير معروف أو مبهم. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* التعبير | *التعبير <code>[[Arduino/include|#include]]</code>: يُستعمَل لتضمين مكتبات خارجية في شيفرتك. | ||
* التعبير | *التعبير <code>[[Arduino/define|#define]]</code>: هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج. | ||
* الرمز <code>;</code>: | *الرمز <code>[[Arduino/semicolon|;]]</code>: يُستعمَل لإنهاء كل تعبير برمجي في لغة أردوينو C. | ||
* الأقواس <code>{}</code>: | *الأقواس <code>[[Arduino/curlybraces|{}]]</code>: | ||
* | *[[Arduino/singlelinecomment|استعمال التعليقات السطرية في أردوينو.]] | ||
== مصادر == | == مصادر == | ||
* [https://www.arduino.cc/reference/en/language/structure/further-syntax/blockcomment/ صفحة التعليقات | * [https://www.arduino.cc/reference/en/language/structure/further-syntax/blockcomment/ صفحة التعليقات متعددة الأسطر في توثيق أردوينو الرسمي.] | ||
[[تصنيف: Arduino]] | |||
[[تصنيف: Arduino Syntax]] | |||
مراجعة 11:23، 9 أكتوبر 2018
التعليقات هي أسطر توضع في الشيفرة ولا تُنفَّذ بهدف توضيح كيفية عمل البرنامج سواءً لك أو لغيرك. تُهمل هذه الأسطر أينما وُجدَت أثناء تفسير الشيفرة ولا تدخل ضمن البرنامج التنفيذي الذي يُرسَل إلى المتحكم ويُكتَب في ذاكرته. هذا يعني أنَّها لا تأخذ أية مساحة من ذاكرة البرنامج (الذاكرة flash) في المتحكم. الهدف الوحيد من استعمال التعليقات هو شرح كيفيَّة عمل البرنامج للمساعدة على فهمه وتذكره عندما تطَّلع أنت أو غيرك على شيفرته بعد فترة من الزمن.
تبدأ التعليقات الكتلية (block comment) أو التعليقات متعددة الأسطر (multi-line comment) بالرمز */ وتنتهي بالرمز /*. يمكن أن يمتد هذا التعليق على عدَّة أسطر بحسب الحاجة؛ ومتى ما قرأ المفسِّر الرمز */، سيتجاهل كل ما كُتِب بعده حتى يصل إلى الرمز /*.
البنية العامة
/* تُكتَب العليقات
في أسطر
متعددة هنا
*/
/**
* شكل آخر من
* التعليقات الكتلية
*/
أمثلة
يوضح المثال التالي كيفية استعمال التعليقات متعددة الأسطر مع التعليقات السطرية:
/* هذا تعليق كتلي في سطر واحد */
/*
// الأسطر التالية هي شرح عن البرنامج وعمله ومالكه وتاريخ نشره
Blink
Turns on an LED on for one second, then off for one second, repeatedly.
This example code is in the public domain.
(Another valid comment)
*/
/*
if (gwb == 0){ // يمكن استعمال تعليق سطري ضمن تعليق كتلي
x = 3; /* ولكن لا يمكن استعمال تعليق كتلي ضمن آخر؛ هذا التعليق خطأ */
}
// لا تنسَ إغلاق التعليق الكتلي
*/
ملاحظات وتحذيرات
أثناء تجريب الشيفرة واختبار عملها، يكون تعليق جزء من الشيفرة هو طريقة ملائمة لحذف الأسطر التي يُشَك بأنَّ الخطأ واقعٌ ضمنها. تعليق الأسطر لا يؤدي إلى حذفها بالمعنى الحرفي من الشيفرة بل الإبقاء عليها في الشيفرة وحذفها من الملف التنفيذي المرسل إلى المتحكم أثناء تفسيرها. هذا الأمر مفيد جدًا ويساعد على تنقيح الشيفرة من الأخطاء وتحصيل مكان الخطأ خصوصًا عندما يرفض المفسِّر تفسير الشيفرة ويرمي خطأَ غير معروف أو مبهم.
انظر أيضًا
- التعبير
#include: يُستعمَل لتضمين مكتبات خارجية في شيفرتك. - التعبير
#define: هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج. - الرمز
;: يُستعمَل لإنهاء كل تعبير برمجي في لغة أردوينو C. - الأقواس
{}: - استعمال التعليقات السطرية في أردوينو.