Comentários em Java

1. Dois tipos de comentários

Devemos acrescentar algumas palavras ao que foi dito acima.

Em Java, você pode escrever comandos, mas também pode adicionar comentários a esses comandos diretamente no código. O compilador ignora completamente os comentários. Quando o programa é executado, todos os comentários são omitidos.

Aqui está um exemplo:

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");
   }
}

Adicionamos o comentário 'Agora vamos exibir a frase…'. O início do comentário é indicado por um par de símbolos ( /*) e o final – por ( */). Quando o programa é compilado, o compilador omite tudo entre os símbolos /*e*/

Você pode escrever o que quiser dentro de um comentário.

Normalmente, os comentários no código são sobre partes do código que são difíceis de entender. Alguns comentários consistem em dezenas de strings: geralmente são escritos antes dos métodos para descrever as nuances de como eles funcionam.

Há mais uma maneira de adicionar um comentário ao código. Você pode usar duas barras ( //).

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");
   }
}

Aqui, o código que começa com //e até o final da linha com //é considerado um comentário. Em outras palavras, não há um segundo par de símbolos usados ​​para 'completar o comentário'.

---

2. Comentários da vida dos programadores

A propósito, alguns comentários são realmente interessantes.

// 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.

Sim, alguns comentários são muito engraçados.

---