I commenti in Java

Per inserire un commento nel codice sorgente di un programma in Java, utilizzo la doppia barra obliqua // all'inizio della riga o del commento.

// commento

Il compilatore Java non elabora le righe commentate per creare il bytecode.

Nel caso in cui le barre si trovino nel mezzo di una riga, il compilatore elabora l'istruzione fino alla doppia barra e ignora tutto il resto.

istruzione java; // commento

A cosa servono i commenti?

Sono utili per spiegare il funzionamento del programma.

Può infatti capitare di dover modificare un codice sorgente scritto molti anni prima oppure sviluppato da altri.

Leggendo i commenti diventa più facile capire come funziona.

    Un esempio pratico

    In questo esempio assegno alla variabile intera annof il valore 2018.

    int annof = 2018; // anno di fatturazione

    Il compilatore elabora la riga fino a //.

    Assegna il valore 2018 alla variabile annof. Poi ignora tutto il resto.

    Grazie al commento posso subito capire che la variabile annof indica l'anno di fatturazione. Se non ci fosse il commento, dovrei prima perdere molto tempo per capirlo.

    In alternativa, avrei potuto anche inserire il commento prima dell'istruzione.

    // annof è l'anno di fatturazione
    int annof = 2018;

    Così facendo però separo l'istruzione e il commento su due righe distinte.

    E' un metodo meno efficace perché nel tempo potrei apportare delle modifiche al codice sorgente che slegano il commento dall'istruzione, facendo perdere la sua utilità.

    Per questa ragione preferisco commentare le singole istruzioni su una sola riga.

    Il commento su più righe

    Nel linguaggio di programmazione Java ci sono diversi modi alternativi per commentare il codice sorgente.

    La doppia barra // è utile per commentare una sola riga di codice.

    Se il commento è molto lungo e si estende su più righe, devo racchiuderlo tra /* e */

    /* un esempio di commento
    su due righe di codice */

    Questo metodo si basa su un tag di apertura ( /* ) e di chiusura ( */ ) del commento. E' simile al linguaggio C.

    Il compilatore Java ignora tutto ciò che si trova tra i due tag.



    Per scrivere un commento

    knowledge base

    Il linguaggio Java