Comentários C ++

“O objetivo dos comentários é servir como um lembrete para você e informar aos outros como seu programa funciona. Explicações de código de texto grandes e trechos de código que precisam ser comentados enquanto os aplicativos de depuração são exemplos de comentários multilinas. O compilador não leva em consideração os comentários. Os comentários em C ++ podem ter uma ou mais linhas. Qualquer personagem presente dentro de um comentário é desconsiderado pelo compilador C ++. Seus comentários devem possibilitar para os usuários externos entenderem seu código.

Se os comentários sobre os detalhes do programa não forem fornecidos, alguém que está lendo uma enorme quantidade de código será perplexo. Tornar um código mais compreensível ao adicionar descrições extras é possível com comentários. Para tornar o código compreensível, os comentários podem conter uma descrição do algoritmo. Se o código precisar ser reutilizado após uma quebra significativa, os comentários também podem ser úteis para o indivíduo. Comentários não devem ser usados ​​como substituição para uma explicação em inglês de código mal escrito. Escrever código limpo e auto-explicativo deve sempre ser uma prioridade. Em seguida, use a seção de comentários.”

Exemplo 1

O comentário de linha única é representada pela barra dupla “//”. Os comentários de linha única são indicados usando-o. Apenas uma linha pode ser comentada por isso. Dado que foi projetado para funcionar com a programação C ++, é conhecido como C ++-Comentários do estilo.

#incluir
// Exemplo de um comentário de linha única
int main ()

// corpo de método principal
std :: cout << "Single line comment in c++";
retornar 0;

Aqui, primeiro importamos a biblioteca iostream com o C ++ incluem palavra -chave. Depois disso, usamos a barra dupla “//” e inserimos uma linha de texto que demonstra que este é um programa de comentários de linha única. Entrando no corpo principal, onde também comentamos a linha de texto, que define que o código está na seção principal do método.

O comentário de linha única não é exibida na tela do console.

Exemplo 2

A/*qualquer linha de texto*/é a representação, com o início de uma barra para a frente e um asterisco (/*) e o final de um asterisco e uma barra para a frente (*/). Comentários de várias linhas são indicados usando-o. Mais de uma linha pode ser afetada pelo comentário. Foi usado pela primeira vez na programação C, daí o nome “Comentário do estilo C.”

/* Usando uma multi-line
Comentário é demonstrado
em um programa C ++.*/
#incluir
int main ()

/* Dentro do comentário multilina, o
O código é explicado. O número variável é
declarado e impresso na tela*/
int num = 25;
std :: cout << "The numbers is:";
std :: cout<retornar 0;

Aqui, iniciamos nosso programa com o comentário multiline. Conforme discutido, o comentário multilina usou a única barra “/” com o sinal de asterisco “*”. Nós envolvemos nosso parágrafo de texto no comentário de multilina. O texto fornece os detalhes de que usamos os comentários multilinas no programa C ++. Em seguida, temos que iniciar a implementação do programa, incluindo o módulo C ++. Depois disso, introduzimos o método principal, dentro do qual usamos novamente o texto comentado de multilina. O comentário multiline explica que "num" é o nome da variável e exibimos o valor variável "num" na tela.

Após a compilação deste programa C ++, apenas a declaração de impressão é exibida no prompt.

Exemplo 3

O código também pode ser desativado nos comentários para impedir que ele seja executado. Por exemplo, em vez de eliminar o código problemático quando encontramos um problema ao executar o programa, podemos usar comentários para impedir que ele seja executado; Esta pode ser uma ferramenta de depuração muito útil.

#incluir
usando namespace std;
int main ()
cout << "C++ Program\n";
// cout <<"Error Program;
cout << "C++ other Program";
retornar 0;

No programa acima, deliberamos deliberadamente um comando de erro no cout. Observe que, no segundo comando cout, a string está fora das citações e utilizamos as citações únicas. Isso gera a exceção.

Aqui está um exemplo de como utilizar comentários como uma ferramenta de depuração. Para evitar gerar um erro, acabamos de comentar sobre o comando de erro.

#incluir
usando namespace std;
int main ()
cout << "C++ Program\n";
// cout <<"Error Program;
cout << "C++ other Program";
retornar 0;

Agora, você vê que o prompt impresso as declarações cout, em vez de gerar uma exceção.

Exemplo 4

Os comentários do bloco são uma forma particular de comentários multilinas que são usados ​​no início de cada arquivo ou função. O criador e o objetivo do arquivo são divulgados nessas observações em bloco. Como criar um comentário em bloco é o seguinte:

• Para manter o comentário alinhado com o código que o segue, a linha inicial é recuada.
• Informações sobre o uso pretendido da classe ou função são fornecidas no comentário.
• Entre a descrição do arquivo e uma lista de tags, há uma linha em branco no comentário.

/*
CS-102 C ++ 11, arquivo.cpp
Objetivo: Comentários de documentação
@Author Linux_User
@version 3.3 16/07/2022
*/
#incluir
usando namespace std;
int main ()
// cout<<"C++ eaxmple of Documentation comment"
// Declaração de cout de impressão
retornar 0;

Aqui, documentamos corretamente este código do programa com os comentários bloqueados. Você pode ver que fornecemos informações sobre o código, que fornece o nome do autor, detalhes do arquivo, versão do software e também a data.

Exemplo 5

Um comentário de linha única pode ser aninhada dentro de outro comentário que tem várias linhas. Para pares de comentários de várias linhas, no entanto, essa lógica é inaplicável. Não há como aninhar um comentário de várias linhas dentro de outro.

#incluir
usando namespace std;
int main ()
/*
// O comentário de linha única
// comentários multilines começam aqui, e a linha de comentários termina aqui */
retornar 0;

Neste exemplo em particular, usamos o comentário de linha única aninhada com a representação de comentários multilinas. Nós envolvemos nosso comentário de linha única com a única barra "/" e o asterisco "*". É assim que podemos comentar várias linhas de texto em c++.

Conclusão

Os comentários C# de linha única e de várias linhas foram examinados. Comentários que são uma linha de longa chegar ao fim no intervalo da primeira linha que vem após o // marcador de comentários. Coloque -o após a declaração do código ou coloque -a no topo. É considerado um comentário se vier após uma declaração de código. Durante a compilação, apenas o texto presente entre os delimitadores de comentários será reconhecido como o comentário.