Commenti in Java

I commenti in Java , come nella maggior parte degli altri linguaggi di programmazione, sono caratteri che vengono ignorati durante l'esecuzione del programma. Pertanto, puoi aggiungere tutti i commenti necessari al programma senza timore di aumentarne le dimensioni. I commenti vengono utilizzati per descrivere le complessità di un particolare blocco di codice, metodo o classe. Puoi anche usarli se vuoi lasciare messaggi per i programmatori che lavoreranno con questo codice in futuro. O per i tuoi appunti.

Modi per evidenziare i commenti

Java ha due modi per evidenziare i commenti nel testo.

Commento sull'implementazione (commento sul codice)

1. Commentare una riga

   Questo è il tipo di commento più comunemente utilizzato. Per scrivere un commento del genere, è necessario utilizzare due barre //. In questo caso il commento inizia subito dopo i caratteri //e prosegue fino alla fine della riga.

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

2. Commentare un blocco di testo

   Se hai bisogno di commenti più lunghi, puoi iniziare ogni riga con dei simboli. Sebbene sia più conveniente limitare i blocchi di commenti a delimitatori /*e file */.

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

   Non dobbiamo dimenticare che i commenti, separati da simboli, /*non possono */essere annidati nel linguaggio Java. Ciò significa che una parte di codice non può essere disabilitata semplicemente racchiudendola tra /*e , poiché il codice da disabilitare può contenere a sua volta */delimitatori /*e */.

Commento documentativo

Per documentare metodi, variabili o classi, viene utilizzato un metodo speciale per evidenziare il testo. Questo viene fatto usando /**e */. In questo caso, ogni riga di testo commentato inizia con *Se un metodo viene documentato, è consuetudine descriverne gli argomenti e restituire il valore.

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

Cos'altro leggere? Ad esempio, questo materiale: Commenti in Java: non tutto è così semplice . Oppure una lezione della ricerca Java Syntax Pro sui commenti.