ความคิดเห็นใน Java

ความคิดเห็นใน Javaเช่นเดียวกับภาษาโปรแกรมอื่นๆ ส่วนใหญ่คืออักขระที่ถูกละเว้นระหว่างการทำงานของโปรแกรม ดังนั้นคุณสามารถเพิ่มความคิดเห็นให้กับโปรแกรมได้มากเท่าที่ต้องการโดยไม่ต้องกลัวว่าจะเพิ่มขนาดของมัน ความคิดเห็นใช้เพื่ออธิบายความซับซ้อนของบล็อกโค้ด วิธีการ หรือคลาสเฉพาะ คุณสามารถใช้มันได้หากคุณต้องการฝากข้อความถึงโปรแกรมเมอร์ที่จะทำงานกับรหัสนี้ในอนาคต หรือสำหรับบันทึกของคุณเอง

วิธีเน้นความคิดเห็น

Java มีสองวิธีในการเน้นความคิดเห็นในข้อความ

ความคิดเห็นการใช้งาน (ความคิดเห็นรหัส)

1. แสดงความคิดเห็นบรรทัด

   นี่เป็นประเภทความคิดเห็นที่ใช้บ่อยที่สุด หากต้องการเขียนความคิดเห็น คุณจะต้องใช้เครื่องหมายทับ 2 //อัน ในกรณีนี้ ความคิดเห็นจะเริ่มต้นทันทีหลังจากอักขระ//และดำเนินต่อไปจนจบบรรทัด

   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 เกี่ยวกับความคิดเห็น