Comentários

Saiba mais

No final desta lição, você será capaz de responder ao seguinte:

• O que são comentários? Por que devo usá-los?

• Como escrevo comentários em C?

Agora que você sabe variáveis e tipos de dados é chegada a hora de comentários, não apenas do código de maquina vive um programa muitas vezes o programador precisa auto entender. Programas são escritos para computadores até este ponto já deves saber, mas às vezes precisamos adicionar um contexto para ajudar outros programadores a ler e entender nosso código.

Comentários são linhas de texto que são ignoradas pelo compilador quando o programa é executado por outro lado é um trufo para entender o que um determinado trecho de código faz.

Geralmente acredita-se que um bom código é autoexplicativo, há um livro famoso de boas praticas chamando de código limpo (Clean code). Mas comentários são úteis para explicar por que um programa foi escrito de uma certa maneira.

Comentário de uma linha

Para escrever um comentário, digite // (duas barras), seguido pelo comentário que deseja adicionar. Tudo depois de // é ignorado até a próxima linha.

  printf("Olá mundo!\n");  // Prints Olá mundo!
  

Um trecho do código pode ser ignorado por comentários isso é bastante útil quando você não quer que seja executar. Por exemplo, se você está tentando encontrar a causa de um erro no seu código (também chamado de depuração), você pode comentar o código que você quer ter certeza de que não está causando o erro.

 printf("Olá mundo!\n"); // Prints Olá mundo!
 printf("Vou a escola\n"); // Prints Vou a escola

 // Esta linha não será impressa printf("EU não GOSTO da escola \n");

printf("Eu, programo em C\n"); // Prints Vou a escola

Múltiplos comentários

De uma outra forma de escrever comentários é o comentário múltiplas. Como o nome sugere, pode utilizá-lo para escrever comentários que abranjam várias linhas. O comentário múltiplo começa por /* e termina por */ (barra asterisco, termina asterisco barra). Tudo o que está entre estes dois elementos é ignorado.

#include <stdio.h>

int main() {
    printf("My favourite:\n");
    printf("Triste\n");
    printf("Velocidade\n");
    
    /*
    printf("Marrocos\n");
    printf("Costa Leste\n");
    printf("Costa Sul\n");
    */
    
    printf("Uige\n");
    printf("Kalandula\n");

    return 0;
}

---

✏️ Actividade de aprendizagem

Use uma mistura de comentários de uma única linha e comentários de várias linhas.