Comentários de várias linhas Java

Comentários de várias linhas Java

As pessoas comentam umas sobre as outras se gostam de algo ou não gostam de algo. Se você já esteve em um site onde deseja aprender algo, deve ter encontrado a seção de feedback em que o autor pede que você escreva seus comentários sobre todo o conteúdo. Em alguns casos, você fornece os comentários e, em alguns casos, tenta não fazer comentários. Assim, as linguagens de programação também tendem a usar os comentários no mesmo arquivo de código. Os programadores gostam de usar esses comentários para se ajudar no futuro a entender o programa, mesmo que fosse buscado após uma década. Também pode ajudar os novos alunos e, se você passar seu código para outra pessoa, ele pode receber ajuda. Este artigo ajuda a entender o uso de comentários de várias linhas junto com os outros tipos.

Exemplo 1: Comentários de linha única

Antes de dar uma olhada nos comentários de várias linhas, precisamos obter uma experiência prática com o básico de usar os comentários na programação Java ou em qualquer outra programação. Os comentários de linha única sempre começam com uma placa de barra dupla "//" na programação Java. O comentário de linha única não possui personagens finais específicos como "/" ou "8". O comentário excede apenas o final da linha e não inclui a próxima linha de código.

Portanto, vamos explicar como adicionar os comentários de linha única em um programa Java para ajudar a entender o código. Para isso, criamos um novo arquivo Java em seu pacote "teste". Este programa começa com a inicialização da classe principal () juntamente com a declaração de sua função principal (). Há um total de três declarações println () utilizadas para exibir uma nova saída todas as vezes na área de saída do console do Eclipse IDE.

Antes de cada declaração de função println (), utilizamos um comentário de linha única nas linhas 4, 6 e 8. Todos esses três comentários de linha única começam com os caracteres "//" de barra dupla e não têm caracteres finais específicos, exceto no caso do terceiro comentário. Nosso terceiro comentário explica o uso da sintaxe de comentário "multi-line" para a declaração de um comentário de linha única. Isso significa que você pode usar os caracteres "/*" de comentários de várias linhas para declarar um comentário de linha única, mas não pode usar o comentário de linha única para declarar um comentário de várias linhas. Para criar um comentário de linha única, precisamos terminar o comentário com "*/" na mesma linha.

Agora, executamos este código com comentários de linha única no método Main () e veja o que acontece. A saída a seguir anexada mostra os dados de texto que são usados ​​em todas as 3 instruções de função println () como Eclipse IDE, Java e Windows. Esta saída está sem nenhum erro ou aviso porque incluímos os comentários muito corretamente no programa.

Exemplo 2: Comentários de várias linhas

Depois de dar uma olhada profunda nos comentários de linha única, discutiremos sobre como adicionar os comentários de várias linhas na programação Java. Para isso, criamos um novo arquivo java chamado “Main.Java "dentro do seu pacote" teste ". O nome de um pacote é gerado automaticamente na primeira linha de código, então você não precisa removê -lo. Caso contrário, pode causar um erro. Assim, começamos nosso programa com uma nova criação de classe, principal. Se você usar um nome de classe diferente do nome do arquivo, você receberá erros na ferramenta Eclipse IDE. Evite usar nomes diferentes.

Depois disso, é hora de adicionar sua função principal () para este programa. Assim, adicionamos esse método main () na classe Main () recém -gerada, pois não vamos usar outras classes ou funções e vamos executar tudo dentro do método principal (). Logo após a declaração do método principal, iniciamos o comentário de várias linhas com os caracteres "/*" no início de sua primeira linha e os caracteres "*/" no final deste comentário na segunda linha.

Este comentário de várias linhas contém apenas 2 linhas. Adicionamos um texto mostrando que é um comentário de várias linhas entre os caracteres "/*" e "*/". Após esse comentário, usamos a declaração de função println () que gera algumas mensagens de texto no console do Eclipse IDE, “Trabalhando no Eclipse IDE”. Depois disso, fechamos a função principal () junto com sua classe, mantendo todo esse código. Salve este código e execute -o através do ícone Eclipse "Run".

Ao tocar no ícone "Run" do Eclipse IDE, temos o texto "Trabalhando no Eclipse IDE", que é exibido na área de saída do Eclipse. Encontramos zero erros e sem avisos porque adicionamos a sintaxe perfeita para comentários de várias linhas junto com toda a sintaxe do código.

Exemplo 3: Comentários Javadoc

Depois de ter conhecimento suficiente sobre os comentários de linha única e de várias linhas, aprenda os comentários do Javadoc, pelo menos por um exemplo. Os comentários do Javadoc são os comentários automáticos que são gerados pelo JDK de um ambiente que você está usando e pode ser adicionado pelo próprio usuário. Para adicionar esses comentários javadoc por si mesmo, você precisa conhecer a sintaxe do comentário javadoc. Uma coisa a lembrar sobre os comentários do javadoc é o uso de um personagem de asterisco "*" no início de cada linha de um comentário javadoc. Este código exibe a soma de dois valores inteiros e a mesma coisa é explicada em seu comentário. O comentário também inclui suas informações de metadados, eu.e. "@Informação sobre o autor.

A saída exibe o valor 10 como a saída da soma.

Conclusão

Após a grande explicação do que são comentários e como eles podem ser utilizados na vida cotidiana, em blogs e programação, discutimos os tipos de comentários em Java. O objetivo de usar os comentários é tornar o bacalhau mais amigável e legível por humanos, especialmente para as novas abelhas da programação. Embora o tópico deste artigo seja discutir os comentários de várias linhas, iniciamos a explicação com os comentários de linha única, para que todo aluno tenha uma idéia básica sobre todos os tipos de comentários. Depois disso, a elaboração de comentários de várias linhas é coberta com um exemplo java.