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.
GO TO FULL VERSION