Java тилиндеги комментарийлер

Java тorндеги комментарийлер , башка программалоо тилдериндегидей эле, программаны аткаруу учурунда этибарга алынбаган символдор. Ошентип, сиз программанын көлөмүн көбөйтүүдөн коркпостон, керек болсо, ошончо комментарий кошо аласыз. Комментарийлер 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 тorнде киргизүү /*мүмкүн эмес экенин унутпашыбыз керек . */Бул codeдун бир бөлүгүн жөн гана /*жана менен курчап коюу менен өчүрүү мүмкүн эмес дегенди билдирет, анткени өчүрүлгөн codeдун өзү жана */бөлүүчүлөрдү камтышы мүмкүн ./**/

Комментарийди documentтештирүү

Методдорду, өзгөрмөлөрдү же класстарды documentтештирүү үчүн текстти бөлүп көрсөтүүнүн атайын ыкмасы колдонулат. /**Бул жана аркылуу жасалат */. Бул учурда комментарий берилген тексттин ар бир сабы менен башталат.Эгер *метод documentтештирorп жатса, анын аргументтерин жана кайтарым маанисин сүрөттөп берүү адатка айланган.

/**
* Метод возвращает максимальное 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 тorндеги комментарийлер: баары ушунчалык жөнөкөй эмес . Же комментарийлер жөнүндө Java Syntax Pro квестинен лекция .