التعليقات Java

في هذا الدليل، ستعرف تعليقات Java، لماذا تستخدمها وكيف تستخدمها بشكل صحيح.

في برمجة الكمبيوتر، التعليقات هي جزء من البرنامج، ويقوم مستكشف Java بتخطيها. إنها تستخدم لتمكين برمجيات البرمجيات من فهم الكود بشكل أفضل. على سبيل المثال،

// إعلان وتحديد قيمة لثلاثة متغيرات
int　a　=1;
int　b　=　3;
// إخراج
System.out.println("This　is　output");

في هذا المكان، استخدمنا التعليقات التالية:

• إعلان وتحديد قيمة لثلاثة متغيرات

• إخراج

نوع التعليقات في Java

في Java، هناك نوعان من التعليقات:

• تعليقات سطر واحدة

• تعليقات متعددة الأسطر

تعليقات سطر واحدة

تعليقات سطر واحدة تبدأ وتنتهي في نفس السطر. لإضافة تعليق سطر واحد، يمكننا استخدام الرمز //. على سبيل المثال،

// "Hello, World!" مثال على برنامج
　
class　Main　{
　　　　public static void main(String[] args) {}}　　　　	
　　　　{
　　　　　　　　// إخراج "Hello, World!"
　　　　　　　　System.out.println("Hello，World!");
　　　　}
}

الخروج:

Hello،World!

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

• "Hello, World!" مثال على برنامج

• إخراج "Hello World!"

مستكشف Java يقوم بتجاهل كل المحتويات من نهاية السطر الذي يحتوي على // حتى نهاية السطر. لذلك، يُطلق عليهنهاية السطرتعليق(تعليقات سطر واحدة)

تعليقات متعددة الأسطر

عندما نريد كتابة تعليقات متعددة الأسطر، يمكننا استخدام تعليقات متعددة الأسطر. لإضافة تعليقات متعددة الأسطر، يمكننا استخدام الرمز /*....*/. على سبيل المثال،

/* هذا مثال على تعليق متعدد الأسطر. */
　* البرنامج سيقوم بطباعة “* Hello،World！” إلى الخروج إلى المعيارية.
　*/
class　HelloWorld　{
　　　　public static void main(String[] args) {}}　　　　	
　　　　{	
　　　　　　　　System.out.println("Hello，World!");
　　　　}
}

الخروج:

Hello،World!

في هذا، نستخدم التعليق المتعدد الأسطر:

/* هذا مثال على تعليق متعدد الأسطر. */
　* البرنامج سيقوم بطباعة “* Hello،World！” إلى الخروج إلى المعيارية.
　*/

هذا النوع من التعليقات يُسمى أيضًاتعليقات تقليدية.” في هذا النوع من التعليقات، سيقوم محرر Java بتخطي كل محتوى من /* إلى */.

استخدام التعليقات بشكل صحيح

يجب أن تعرف دائمًا شيئًا واحدًا، وهو أن التعليقات لا يجب أن تكون بديلاً عن شرح الكود السيء. يجب أن تكتب دائمًا كودًا منظمًا وقابلًا للتفسير الذاتي. ثم، تأمل في استخدام التعليقات.

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

ملاحظةفي معظم الحالات، يرجى دائمًا استخدام التعليقات لتوضيح “ لماذا ” بدلاً من “ كيفية القيام بذلك 。”