Comentários

Quando estamos empenhados na tarefa de escrever uma aplicação, é fundamental tomarmos algumas providências para que não nos percamos nas diversas linhas de código que por ventura utilizaremos. Uma coisa muito útil que podemos, ou melhor, que devemos fazer é colocar comentários que nos esclareçam a utilidade das diversas partes do código. Evidentemente, você já tem percebido que, junto às linhas de código, nós colocamos algumas frases esclarecedoras dentro de um par de barras com asterisco /* */, ou imediatamente após duas barras //. Essas frases são os comentários.

C++ aceita esses dois estilos de comentários:

/* Esse estilo de comentário é derivado da linguagem C. Ele é aberto 
com uma barra seguida de um asterisco. Tudo aquilo que estiver após 
essa chave de abertura, até encontrar uma chave de fechamento (um 
asterisco e uma barra) será desconsiderado pelo compilador */


// Essas duas barras significam comentários no estilo C++.
// Uma vez aberto, esse comentário não precisa ser fechado.
// Mas ele só vale para a linha em que foi aberto,
// a partir do ponto em que foi aberto
// e até o final da linha nada mais será considerado

Comentários também podem ser úteis para tirar o efeito de determinadas partes de código, quando estamos fazendo experiências. Você já viu tal fato, nos exemplos que colocamos o código para apresentar a data ou a hora. Se você retirar as chaves de abertura e de fechamento, perceberá que o resultado do programa será diferente.

Abaixo apresentamos um exemplo de como podemos usar comentários para retirar efeitos de um código que já usamos anteriormente. Compile e execute para ver que o resultado do programa será outro:

void __fastcall TForm1::Button1Click(TObject *Sender)
{
// Label1 -> Caption = "Testando propriedades";
// Edit1->Text = "Continuando o teste ...";
/* ListBox1->Items-> Add(Label1 -> Caption);
ListBox1->Items-> Add("Testando ..."); */
ComboBox1 -> Text = "Fala, Grande!";
ComboBox1 -> Items -> Add(Label1 -> Caption);
ComboBox1 -> Items -> Add("Fala, Grande...");
ComboBox1 -> Items -> Add(Edit1->Text);
}