Um comentário de código explica algo sobre o código ou o raciocínio da programação do código. Quando o programa é executado, os comentários de código são ignorados.
|
comentário de linha única: Tudo que apareça entre # e o final da linha faz parte do comentário do código. |
|
Comentário de bloco em linha: Tudo que apareça entre <# e #> faz parte do comentário do código. Comentários de bloco em linha podem estar entre expressões em uma única linha e não alteram essas expressões. |
~~~(verse)
DoThis()
<# E eles
podem ter várias
linhas longas #>
DoThat()
|
Comentário de bloco multilinha: Tudo que apareça entre <# e #> faz parte do comentário do código. Comentários de bloco multilinha podem abranger várias linhas. |
~~~(verse) <# Comentários em bloco se aninham <# assim #> #>
|
Comentário de bloco aninhado: Tudo que apareça entre <# e #> faz parte do comentário do código e pode ser aninhado. O que pode ser útil se você quiser comentar algumas expressões em uma linha para teste e depuração sem alterar um comentário de código existente. |
~~~(verse)
<#>
Está é uma descrição
longa que se estende
por várias linhas.
DoThis() # Esta expressão não faz parte do comentário recuado
|
Comentário recuado: Tudo que apareça em novas linhas após <#> e fique recuado quatro espaços faz parte do comentário do código. A primeira linha que não fica recuada quatro espaços não faz parte do comentário do código e encerra o comentário do código. |