Java-da şərhlər

Java-da şərhlər , əksər digər proqramlaşdırma dillərində olduğu kimi, proqramın icrası zamanı nəzərə alınmayan simvollardır. Beləliklə, ölçüsünü artırmaqdan qorxmadan proqrama lazım olan qədər şərh əlavə edə bilərsiniz. Şərhlər müəyyən kod blokunun, metodun və ya sinifin incəliklərini təsvir etmək üçün istifadə olunur. Gələcəkdə bu kodla işləyəcək proqramçılar üçün mesajlar buraxmaq istəyirsinizsə, onlardan da istifadə edə bilərsiniz. Və ya öz qeydləriniz üçün.

Şərhləri vurğulamaq yolları

Java-nın mətndəki şərhləri vurğulamaq üçün iki yolu var.

İcra şərhi (kod şərhi)

1. Bir xətti şərh edir

   Bu ən çox istifadə edilən şərh növüdür. Belə bir şərh yazmaq üçün iki əyri işarədən istifadə etməlisiniz //. Bu halda şərh simvollardan dərhal sonra başlayır //və sətrin sonuna qədər davam edir.

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

2. Mətn blokunu şərh etmək

   Əgər daha uzun şərhlərə ehtiyacınız varsa, hər sətri simvollarla başlaya bilərsiniz. Baxmayaraq ki, şərh bloklarını məhdudlaşdırıcılarla məhdudlaşdırmaq daha rahatdır /*və */.

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

   Unutmamalıyıq ki, simvollarla ayrılmış şərhlər Java dilində yuvalana /*bilməz . */Bu o deməkdir ki, kod parçası sadəcə onu /*və ilə əhatə etməklə qeyri-aktiv edilə bilməz, çünki deaktiv edilən kodun özündə və */ayırıcılar ola bilər ./**/

Şərhin sənədləşdirilməsi

Metodları, dəyişənləri və ya sinifləri sənədləşdirmək üçün mətni vurğulamaq üçün xüsusi bir üsul istifadə olunur. /**Bu və istifadə edərək edilir */. Bu halda şərh edilən mətnin hər bir sətri ilə başlayır.Əgər *metod sənədləşdirilibsə, onun arqumentlərini və dəyərini qaytarmaq adətdir.

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

Başqa nə oxumalı? Məsələn, bu material: Java-da şərhlər: hər şey o qədər də sadə deyil . Və ya şərhlər haqqında Java Syntax Pro axtarışından mühazirə .