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 бөлігін жай /*және арқылы қоршау арқылы өшіруге болмайтынын білдіреді, себебі ажыратылған 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 квестінен түсініктемелер туралы лекция .