Adicionar um bloco de comentários no início de um método é útil para adicionar uma nota sobre o que um método faz, bem como uma lista de parâmetros de entrada/saída. E ter algumas linhas de texto legível por humanos dentro de uma secção complicada de código pode ser conveniente para o ajudar a si e a outros a recordar o objectivo desta secção específica de código. Começando com 4D v18, a sua experiência de programação é reforçada com a adição de blocos de comentários!
Os comentários são textos (notas, descrições, lembretes, etc.) no código fonte, designados com caracteres especiais para que sejam ignorados pelo compilador durante a execução do código. Os comentários podem ser sobre um único comentário de linha ou através de múltiplas linhas. Agora, em vez de ter muitas linhas prefixadas com //, pode simplesmente usar /* no início de um comentário e */ no final para comentar um bloco inteiro. Também pode colapsar e expandi-los! E não é tudo, pode até adicionar comentários a qualquer parte de uma linha, mesmo dentro de uma condição if ou de um laço:
Porque é que os comentários são importantes
- Numa equipa com vários programadores a trabalhar no mesmo projecto, um código bem comentado é útil para outros que trabalham no mesmo para que possam compreender melhor o código e facilitar o processo de revisão/debugging do código.
- Somos apenas humanos e esquecer as coisas é completamente normal. Se vir ou editar o seu código mais tarde, os comentários podem ajudá-lo a lembrar-se da lógica que utilizou ao escrever esse código. Mesmo que escreva um código realmente simples, tente lê-lo meses ou anos mais tarde. Continuará a parecer simples, ou gostaria de ter acrescentado comentários?