Java-da sharhlar

Ko'pgina boshqa dasturlash tillarida bo'lgani kabi Java-da ham sharhlar dasturni bajarish paytida e'tiborga olinmaydigan belgilardir. Shunday qilib, dastur hajmini oshirishdan qo'rqmasdan, kerak bo'lganda, shuncha ko'p sharh qo'shishingiz mumkin. Sharhlar ma'lum bir kod bloki, usul yoki sinfning nozik tomonlarini tavsiflash uchun ishlatiladi. Agar siz kelajakda ushbu kod bilan ishlaydigan dasturchilar uchun xabar qoldirmoqchi bo'lsangiz, ulardan foydalanishingiz mumkin. Yoki o'z qaydlaringiz uchun.

Izohlarni ta'kidlash usullari

Java matndagi sharhlarni ajratib ko'rsatishning ikkita usuliga ega.

Amalga oshirish sharhi (kod sharhi)

1. Bir qatorni sharhlash

   Bu eng ko'p ishlatiladigan sharh turi. Bunday sharh yozish uchun siz ikkita oldinga qiyshaygan chiziqdan foydalanishingiz kerak //. Bunday holda, sharh belgilardan keyin darhol boshlanadi //va satr oxirigacha davom etadi.

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

2. Matn blokiga sharh berish

   Agar sizga uzunroq izohlar kerak bo'lsa, har bir qatorni belgilar bilan boshlashingiz mumkin. /*Sharh bloklarini cheklovchilar va ga cheklash qulayroq bo'lsa-da */.

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

   Belgilar bilan ajratilgan izohlarni Java tilida joylashtirish /*mumkin emasligini unutmasligimiz kerak . */Bu shuni anglatadiki, kod qismini shunchaki /*va bilan o'rab bo'lmaydi, chunki o'chirilgan kodning o'zi va */chegaralovchilarni o'z ichiga olishi mumkin ./**/

Sharhni hujjatlashtirish

Usullarni, o'zgaruvchilarni yoki sinflarni hujjatlashtirish uchun matnni ajratib ko'rsatishning maxsus usuli qo'llaniladi. Bu /**va yordamida amalga oshiriladi */. Bu holda sharhlangan matnning har bir satri bilan boshlanadi.Agar *usul hujjatlashtirilayotgan bo'lsa, uning argumentlari va qiymatini qaytarish odatiy holdir.

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

Yana nimani o'qish kerak? Masalan, ushbu material: Java-da sharhlar: hamma narsa juda oddiy emas . Yoki sharhlar haqida Java Syntax Pro kvestidan ma'ruza .