הערות ב-Java

הערות ב-Java , כמו ברוב שפות התכנות האחרות, הן תווים שמתעלמים מהם במהלך הפעלת התוכנית. כך, ניתן להוסיף הערות רבות לתוכנית לפי הצורך מבלי לחשוש מהגדלת גודלה. הערות משמשות לתיאור המורכבות של בלוק מסוים של קוד, שיטה או מחלקה. אתה יכול להשתמש בהם גם אם אתה רוצה להשאיר הודעות למתכנתים שיעבדו עם הקוד הזה בעתיד. או להערות שלך.

דרכים להדגיש הערות

ל- Java יש שתי דרכים להדגיש הערות בטקסט.

הערת יישום (הערת קוד)

1. מעיר שורה

   זהו סוג ההערות הנפוץ ביותר. כדי לכתוב תגובה כזו, אתה צריך להשתמש בשני קווים קדמיים //. במקרה זה, ההערה מתחילה מיד לאחר התווים //ונמשכת עד סוף השורה.

   System.out.println("Hello, Java world!");
   // наш комментарий

2. הערה לגוש טקסט

   אם אתה צריך הערות ארוכות יותר, אתה יכול להתחיל כל שורה בסמלים. למרות שנוח יותר להגביל בלוקים של הערות למפרידים /*ו- */.

   /*
    Пример простой программы на Java
   */
   
   public class SampleProgram
   {
    public static void main (String [] args)
    {
    System.out.println("Hello, Java world!");
    }
   }

   אל לנו לשכוח שלא /*ניתן לקנן הערות, מופרדות על ידי סמלים, */בשפת Java. משמעות הדבר היא שלא ניתן להשבית קטע קוד פשוט על ידי הקיפתו עם /*ו , מכיוון שהקוד המושבת עשוי להכיל בעצמו תוחמים */ומפרידים ./**/

הערה מתעדת

כדי לתעד שיטות, משתנים או מחלקות, נעשה שימוש בשיטה מיוחדת להדגשת טקסט. זה נעשה באמצעות /**ו */. במקרה זה, כל שורת טקסט מוערת מתחילה ב *. אם מתעדת שיטה, נהוג לתאר את הארגומנטים שלה ואת ערך ההחזרה.

/**
* Метод возвращает максимальное meaning
* из трех переданных аргументов
* @param a - первый параметр
* @param b - второй параметр
* @param c - третий параметр
* @return - максимальный из параметров
*/
public int max(int a, int b, int c) {
   return Math.max(Math.max(a, b), c);
}

מה עוד לקרוא? לדוגמה, החומר הזה: הערות ב-Java: לא הכל כל כך פשוט . או הרצאה מהמסע של Java Syntax Pro על הערות.