Komen dalam Java

Komen dalam Java , seperti dalam kebanyakan bahasa pengaturcaraan lain, adalah aksara yang diabaikan semasa pelaksanaan program. Oleh itu, anda boleh menambah seberapa banyak komen pada program yang diperlukan tanpa rasa takut untuk meningkatkan saiznya. Komen digunakan untuk menerangkan selok-belok blok kod, kaedah atau kelas tertentu. Anda juga boleh menggunakannya jika anda ingin meninggalkan mesej untuk pengaturcara yang akan bekerja dengan kod ini pada masa hadapan. Atau untuk nota anda sendiri.

Cara untuk menyerlahkan komen

Java mempunyai dua cara untuk menyerlahkan komen dalam teks.

Komen pelaksanaan (komen kod)

1. Mengulas baris

   Ini ialah jenis ulasan yang paling biasa digunakan. Untuk menulis ulasan sedemikian, anda perlu menggunakan dua garis miring ke hadapan //. Dalam kes ini, ulasan bermula serta-merta selepas aksara //dan berterusan sehingga penghujung baris.

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

2. Mengulas blok teks

   Jika anda memerlukan ulasan yang lebih panjang, anda boleh memulakan setiap baris dengan simbol. Walaupun lebih mudah untuk mengehadkan blok ulasan kepada pembatas /*dan */.

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

   Kita tidak harus lupa bahawa komen, dipisahkan oleh simbol, /*tidak boleh */bersarang dalam bahasa Java. Ini bermakna bahawa sekeping kod tidak boleh dilumpuhkan hanya dengan mengelilinginya dengan /*dan , memandangkan kod yang dilumpuhkan itu mungkin mengandungi dan */membataskan sendiri ./**/

Mendokumentasikan ulasan

Untuk mendokumentasikan kaedah, pembolehubah atau kelas, kaedah khas untuk menyerlahkan teks digunakan. Ini dilakukan menggunakan /**dan */. Dalam kes ini, setiap baris teks yang diulas bermula dengan *. Jika kaedah didokumenkan, adalah lazim untuk menerangkan hujahnya dan mengembalikan nilai.

/**
* Метод возвращает максимальное 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);
}

Apa lagi yang perlu dibaca? Sebagai contoh, bahan ini: Komen dalam Java: tidak semuanya begitu mudah . Atau kuliah daripada pencarian Java Syntax Pro tentang ulasan.