Шарҳҳо дар Java

Шарҳҳо дар Java , чун дар аксари забонҳои барномасозӣ, аломатҳое мебошанд, ки ҳангоми иҷрои барнома нодида гирифта мешаванд. Ҳамин тариқ, шумо метавонед бидуни тарси зиёд кардани андозаи он ба барнома миқдори зиёди шарҳҳо илова кунед. Шарҳҳо барои тавсифи нозукиҳои блоки мушаххаси code, усул ё синф истифода мешаванд. Шумо инчунин метавонед онҳоро истифода баред, агар шумо хоҳед, ки барои барномасозоне, ки дар оянда бо ин code кор хоҳанд кард, паём гузоред. Ё барои қайдҳои худ.

Роҳҳои таъкид кардани шарҳҳо

Java дорои ду роҳ барои таъкид кардани шарҳҳо дар матн аст.

Шарҳи татбиқ (шарҳи code)

1. Шарҳ додани сатр

   Ин навъи шарҳи маъмултарин аст. Барои навиштани чунин шарҳ, ба шумо лозим аст, ки ду хатти хати ростро истифода баред //. Дар ин ҳолат шарҳ фавран пас аз аломатҳо оғоз мешавад //ва то охири сатр идома меёбад.

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

2. Шарҳ додани блоки матн

   Агар ба шумо шарҳҳои дарозтар лозим бошад, шумо метавонед ҳар як сатрро бо аломатҳо оғоз кунед. Ҳарчанд қулайтар аст, ки блокҳои шарҳҳоро ба ҷудокунакҳо /*ва */.

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

   Мо набояд фаромӯш кунем, ки шарҳҳое, ки бо аломатҳо ҷудо шудаанд, /*наметавонанд */дар забони Java ҷойгир карда шаванд. Ин маънои онро дорад, ки порчаи codeро танҳо бо иҳота кардани он бо /*ва ғайрифаъол кардан мумкин нест, зеро рамзи ғайрифаъолшуда метавонад худаш ва */ҷудокунандаҳоро дар бар гирад ./**/

Ҳуҷҷатгузории шарҳ

Барои ҳуҷҷатгузории усулҳо, тағирёбандаҳо ё синфҳо усули махсуси равшан кардани матн истифода мешавад. Ин бо истифода /**аз ва анҷом дода мешавад */. Дар ин ҳолат, ҳар як сатри матни шарҳ додашуда бо *.Оғоз мешавад.Агар усул ҳуҷҷатгузорӣ шуда бошад, одат шудааст, ки аргументҳои он ва арзиши баргардонидани онро тавсиф кунанд.

/**
* Метод возвращает максимальное 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 дар бораи шарҳҳо.