التعليقات

في Java، التعليقات عبارة عن عبارات غير قابلة للتنفيذ ويتم تجاهلها بواسطة المترجم. يتم استخدامها لتقديم التوضيحات والوثائق والشروح داخل التعليمات البرمجية. هناك ثلاثة أنواع من التعليقات في Java:

1. التعليقات ذات السطر الواحد: تبدأ التعليقات ذات السطر الواحد بخطين مائلين للأمام (//). كل شيء بعد // على نفس السطر يعتبر تعليقًا ويتم تجاهله بواسطة المترجم. تُستخدم التعليقات المكونة من سطر واحد عادةً للتفسيرات القصيرة أو التعليقات على سطر واحد من التعليمات البرمجية.
   مثال:

   // This is a single-line comment
   

2. التعليقات متعددة الأسطر: التعليقات متعددة الأسطر، والمعروفة أيضًا باسم التعليقات الجماعية، تكون محاطة بين /* و*/. كل ما بين هذه الرموز، بما في ذلك الأسطر الجديدة، يعتبر تعليقًا. غالبًا ما تُستخدم التعليقات متعددة الأسطر للتفسيرات الأطول أو التعليقات التي تمتد إلى عدة أسطر من التعليمات البرمجية.
   مثال:

   /* This is a
      multi-line comment */
   

3. تعليقات Javadoc: تعليقات Javadoc هي نوع خاص من التعليقات يُستخدم لإنشاء الوثائق. تبدأ بـ /** وتنتهي بـ */. تُستخدم تعليقات Javadoc لوصف الفئات والأساليب والحقول، ويمكن أن تتضمن علامات خاصة لتوفير معلومات إضافية مثل المعلمات وقيم الإرجاع والاستثناءات.
   مثال:

   /**
    * This is a Javadoc comment for the MyClass class.
    */
   public class MyClass {
       /**
        * This is a Javadoc comment for the myMethod method.
        * @param x This is a parameter of the method.
        * @return This method returns a value.
        */
       public int myMethod(int x) {
           return x * x;
       }
   }
   

سلاسل الهروب:

في Java، تسلسلات الهروب عبارة عن مجموعات أحرف خاصة تستخدم لتمثيل الأحرف التي يصعب أو يستحيل تمثيلها مباشرة في سلسلة حرفية. تُسبق تسلسلات الهروب بحرف شرطة مائلة عكسية (). فيما يلي بعض تسلسلات الهروب الشائعة المستخدمة في Java:

1. n\: يمثل حرف السطر الجديد. عند استخدامها ضمن سلسلة حرفية، فإنها تنقل المؤشر إلى بداية السطر التالي.
2. t\: يمثل حرف علامة التبويب. عند استخدامها ضمن سلسلة حرفية، فإنها تُدرج علامة تبويب أفقية.
3. '\: يمثل حرف اقتباس واحد. يستخدم لتضمين علامة اقتباس مفردة ضمن سلسلة حرفية.
4. "\: يمثل حرف الاقتباس المزدوج. يستخدم لتضمين علامات الاقتباس المزدوجة داخل سلسلة حرفية.
5. \\: يمثل حرف الخط المائل العكسي. تستخدم لتضمين شرطة مائلة عكسية داخل سلسلة حرفية.
6. r\: يمثل حرف إرجاع.
7. b\: يمثل حرف مسافة للخلف.
8. f\: يمثل حرف تغذية النموذج.

مثال:

public class EscapeSequencesExample {
    public static void main(String[] args) {
        // Newline (\n) escape sequence
        System.out.println("Hello\nWorld"); // Output: Hello
                                            //         World
        
        // Tab (\t) escape sequence
        System.out.println("Java\tProgramming"); // Output: Java    Programming
        
        // Double quote (\") escape sequence
        System.out.println("She said, \"Hello!\""); // Output: She said, "Hello!"
        
        // Backslash (\\) escape sequence
        System.out.println("C:\\Users\\John\\Documents"); // Output: C:\Users\John\Documents
        
        // Carriage return (\r) escape sequence
        System.out.println("Overwritten text\r123"); // Output: 123written text
        
        // Backspace (\b) escape sequence
        System.out.println("Back\bspace"); // Output: Backspace
        
        // Form feed (\f) escape sequence
        System.out.println("Hello\fWorld"); // Output: Hello
                                             //         World

    }
}