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 + إستخداماتهم✔