الكورس

Advertisements

JAVA Comments


التعليقات فى لغة Java

 

فى أى لغة برمجة تستخدم التعليقات ‘comments’ لشرح الكود ولجعله أكثر قابلية للقراءة والفهم + يمكن استخدام التعليقات لمنع تنفيذ كود معين عند اختبار كود بديل.

تحتوي Java على ثلاثة أنواع من التعليقات:

  1. التعليقات التقليدية Traditional comments.
  2. تعليقات نهاية السطر End-of-line.
  3. تعليقات الوثائق Documentation comments.

 


Traditional comments

 

التعليقات التقليدية، المعروفة أيضًا باسم block comments، تبدأ بـ */ وتنتهي بـ /* ، وقد تمتد عبر أسطر متعددة.

مثال للتوضيح:

/* This is a multi-line comment.
& This code below will print "Hello World!". */

System.out.println("Hello World!");

💡 سيتم تجاهل أي نص بين /*  و  */ بواسطة Java.


End-of-line

 

تبدأ تعليقات نهاية السطر بـ // وتمتد حتى نهاية السطر الحالي:

System.out.println("Hello World!"); // Output = Hello World!

الإستخدام الأساسى لهذا النوع من التعليقات فى نهاية سطر الكود، لكن يمكن إستخدام هذا النوع قبل أو بعد الكود أيضًا:

/* This is comment. */

System.out.println("Hello World!");

/* This is comment. */

Documentation comments

 

تتم معالجة تعليقات الوثائق في ملفات المصدر بواسطة أداة Javadoc لإنشاء وثائق.

هذا النوع من التعليقات مطابق للتعليقات التقليدية ، باستثناء أنه يبدأ بـ **/ ويتبع اصطلاحات محددة بواسطة أداة Javadoc.

 

مثال للتوضيح:

/**
 * This is a documentation comment.
 * 
 * @author: Hamed Esam
 * Website: albashmoparmeg.com
 * .....etc
 */

💡 من الناحية الفنية: تعد هذه التعليقات نوعًا خاصًا من التعليقات التقليدية ولا يتم تعريفها بشكل خاص في مواصفات اللغة.


💡ملاحظة 1: تم اشتقاق معظم هذه الأنواع من التعليقات من لغة C و ++C.

💡 ملاحظة 2: نستخدم:

  • // للتعليقات القصيرة.
  • و /*  */ للتعليقات الأطول.

 


 

💡 Done: فى هذا الفصل تعرفنا على جميع أنواع التعليقات فى لغة Java + إستخداماتهم✔

 



الإبلاغ عن خطأ

×

إذا وجد خطأ وتريد الإبلاغ عن هذا الخطأ، أو إذا كنت تريد تقديم اقتراح على شىء معين، فلا تتردد في إرسال بريد إلكتروني إلينا:

[email protected]

شكرًا لك على مساعدتك لنا!

Advertisements