Comentarii în Java

1. Două tipuri de comentarii

Ar trebui să adăugăm câteva cuvinte la cele spuse mai sus.

În Java, puteți scrie comenzi, dar puteți adăuga și comentarii la aceste comenzi chiar în cod. Compilatorul ignoră complet comentariile. Când programul este rulat, toate comentariile sunt omise.

Iată un exemplu:

public class Home
{
   public static void main (String[] args)
   {
      /*
      Now we'll display the phrase 'Amigo is the Best'
      */
      System.out.print("Amigo ");
      System.out.print("is the ");
      System.out.print("Best");
   }
}

Am adăugat comentariul „Acum vom afișa expresia…”. Începutul comentariului este indicat de o pereche de simboluri ( /*), iar sfârșitul – de ( */). Când programul este compilat, compilatorul omite totul dintre simboluri /*și*/

Puteți scrie orice doriți într-un comentariu.

De obicei, comentariile din cod sunt despre părți ale codului care sunt greu de înțeles. Unele comentarii constau din zeci de șiruri de caractere: acestea sunt adesea scrise înaintea metodelor pentru a descrie nuanțele în modul în care funcționează.

Mai există o modalitate de a adăuga un comentariu la cod. Puteți utiliza două bare oblice înainte ( //).

public class Home
{
   public static void main (String[] args)
   {
      System.out.print("Amigo ");
      System.out.print("is the "); // This is also a comment
      System.out.print("Best");
   }
}

Aici, codul care începe cu //și până la sfârșitul rândului cu //este considerat a fi un comentariu. Cu alte cuvinte, nu există o a doua pereche de simboluri folosită pentru a „completa comentariul”.

2. Comentarii din viata programatorilor

Apropo, unele comentarii sunt chiar interesante.

// I'm not responsible for this code. I was forced to write it against my will.

// Dear, future me. Please forgive me for this code.

// If I see something like this once more, I'll have a complete mental breakdown at work.

// If this condition is ever satisfied, please inform me for a reward. Phone: xxx-xxx-xxx.

//
// Dear programmer:
//
// When you finish 'optimizing' this subroutine
// and realize what a huge mistake it was,
// please increment the following counter as a warning
// to the next guy:
//
// total_hours_wasted_here = 42
//

// When I wrote this, only God and I understood what I was doing
// Now only God knows.

// Sometimes it seems that the compiler is just ignoring all my comments

// I dedicate all my code and my work to my wife Darlene,
// who will have to provide for me, our three kids, and the dog when
// it gets released to the public.

// Magic. Don't touch.

Da, unele comentarii sunt foarte amuzante.