Şərhlər Java-da

1. İki növ şərh

Yuxarıda deyilənlərə bir neçə söz əlavə etmək istəyirəm.

Java dilində siz yalnız əmrlər deyil, həm də onlara şərhlər yaza bilərsiniz. Bu cür şərhlər kompilyator tərəfindən nəzərə alınmır, sanki ümumiyyətlə yoxdur. Proqram icra edilərkən bütün şərhlər ötürülür.

Bax, nümunə:

public class Home
{
   public static void main (String[] args)
   {
      /*
      İndi biz ekrana 'Amigo the Best' ifadəsini çıxarırıq
      */
      System.out.print("Amigo ");
      System.out.print("the ");
      System.out.print("Best");
   }
}

Kodda biz “İndi biz ekrana ifadəni çıxarırıq ...” adlı bir şərh yazmışıq. Şərhin başlanğıcı /* cüt simvolu ilə, sonu isə */ ilə müəyyən edilir. Proqram kompilyasiya edildikdə, kompilyator /* və */ arasındakı hər şeyi ötürəcək.

Şərh içərisində istənilən şeyi yaza bilərsiniz.

Adətən kodda onun anlaşılmaz və ya çətin hissələrinə müxtəlif şərhlər yazılır. Onlarla sətrdən ibarət şərhlər də olur: bunlar adətən metodların əvvəlində, onların işinin incəliklərini təsvir etmək üçün yazılır.

Koddakı şərhləri yazmaq üçün başqa bir üsul da var — // simvollarından istifadə edərək.

public class Home
{
   public static void main (String[] args)
   {
      System.out.print("Amigo ");
      System.out.print("the "); // bax burada başqa bir şərh var
      System.out.print("Best");
   }
}

Bununla şərh // cüt simvollarından və onların yerləşdiyi sətirin sonuna qədər olan hissədən ibarət hesab edilir. Yəni, şərhi “bağlayan” ikinci bir cüt simvol yoxdur.

2. Proqramçıların həyatından şərhlər

Bəzən, kodda çox maraqlı şərhlər qarşımıza çıxır:

// Mən bu koda görə məsuliyyət daşımıram. Məni bunu yazmağa məcbur etdilər istəməmişdim.

// Əziz mən_gələcəkdən! Zəhmət olmasa, bu kod üçün məni bağışla.

// Əgər bir daha belə bir şey görsəm, işə silah gətirməyə başlayacam.

// Əgər bu şərt bir gün icra olunsa, zəhmət olmasa, mənə tel. xxx-xxx-xxx nömrəsinə zəng edib mükafat alın.

//
// Əziz proqramçı:
//
// Bu subroutini «optimizasiya» etməklə işini bitirdikdən
// sonra bunun necə böyük bir səhv olduğunu anladığında,
// zəhmət olmasa aşağıdakı sayğacı artır ki,
// növbəti şəxs xəbərdar olsun:
//
// burada_sərf_olunan_saatların_sayı = 42
//

// Mən bunu yazmağa başlayanda, yalnız Tanrı ilə mən nə etdiyimi anlayırdıq. // İndi isə yalnız Tanrı başa düşür

// bəzən elə gəlir ki, kompilator mənim bütün şərhlərimi görməzdən gəlir

// Mən bütün kodumu, bütün işimi həyat yoldaşım Darlinə həsr edirəm // kim ki, məni, üç uşağımızı və iti dolandırmalı olacaq // bu iş açıq çıxdıqda.

// sərxoş idim, sonra düzəldərəm

// Sehrdir. Toxunma.

Bəli, şərhlər çox əyləncəli ola bilər.