Cuidados gerais

Ao escrever um código-fonte em C++, algumas precauções extras devem ser adotadas.

1. Deixar o código o mais claro e compreensível possível, inserindo comentários e usando-os adequadamente, bem como tomar bastante cuidado com a grande liberalidade na forma que o formato livre admite.

Documentar o trabalho

Em princípio, comentários são textos que inserimos no programa para esclarecer qual é a tarefa que determinado comando realiza. Comentários são muito importantes em nossos códigos C++. A linguagem C++ suporta dois estilos de comentários:

a) comentário no estilo C: /* ...*/

/* Neste tipo de comentário, tudo aquilo que estiver inserido entre a 
chave de abertura do comentário (barra e asterisco) e a chave de fechamento 
do comentário (asterisco e barra) será desconsiderado pelo compilador, 
independentemente da quantidade de linhas usadas. */

b) comentário no estilo C++: //

// Neste tipo de comentário, tudo aquilo que estiver inserido à direita
// do comentário (barras duplas), até o final da linha
// será desconsiderado pelo compilador.
// Neste estilo, a cada nova linha, 
// precisamos iniciar um novo comentário.

Outra aplicação que podemos dar aos comentários, é a de tirar, temporariamente, a validade de uma parte do programa:

// cout << " Esta mensagem não aparece na tela! \n";
/* cout << Esta mensagem não aparece na tela! \n"; *

Uma vez iniciado um comentário no estilo C, não podemos inserir outro comentário dentro deste, pois o compilador considerará apenas a primeira chave de fechamento, o quê ocasionará um erro:

/* Abrimos um comentário no estilo C; /* até a primeira chave de 
fechamento não há problemas, pois a abertura desse novo comentário, 
na verdade não ocorreu, sendo considerada parte integrante do 
comentário inicial */ aqui começa a parte ilegal do comentário, e o 
compilador deve acusar o erro */

Cuidado com o formato livre

Há uma grande liberalidade na forma em que podemos escrever um código C++, o que significa que o posicionamento de alguns comandos ou caracteres dentro do texto, de regra, não influenciarão no resultado da compilação. Esclarecendo melhor, espaços, tabulações, retornos ou comandos escritos em novas linhas são caracteres desconsiderados pelo compilador.

Abaixo transcrevemos um mesmo programa escrito de três formas diferentes:

void main(void) { cout << " C++ possui formato livre!!!\n"; getch(); }

void main ( void ) { cout << " C++ possui formato livre!!!\n" ; getch ( ) ; }

void main(void){cout << " C++ possui formato livre!!!\n";getch();}

O resultado apresentado pelo programa acima é rigorosamente o mesmo em qualquer das três hipóteses.

Evidentemente, se, quando trabalharmos num projeto, não tivermos cuidado de escrever um bom e legível código, o resultado poderá apresentar-se bagunçado, dificultando sua compreensão e, até mesmo, a localização e conserto de bugs (erros no código que afetam diretamente o resultado) no programa.

Certamente em pouco tempo você já estará desenvolvendo sua própria técnica para escrever bons programas, usando o formato livre a seu favor.

2. Cuidado com o uso de letras maiúsculas e minúsculas

C++ é Case Sensitive

C++ é Case Sensitive, isto é, letras maiúsculas e minúsculas são interpretadas de forma diferente pelo compilador. Dentre outras implicações, isso significa que se, por acaso, declararmos uma variável com o nome Temp, os seguintes nomes terão significados diferentes: TemP; TEMP; temp; tEmp; TeMp. Atenção especial devemos ter quando escrevemos os comandos da linguagem nas instruções dos códigos-fontes, bem como com algumas funções pré-existentes. Boa parte desses comandos são digitados com letras minúsculas, como por exemplo: cout, cin, if, else, while, do ... while, for, switch ... case, include, iostream.h, conio.h, open(), getch(), define, undef, \n, \t, \a etc. Mas essa regra, dependendo do compilador, não é absoluta e comporta exceções, como algumas funções ou classes internas do C++ Builder, como ShowMessage() ou AnsiString ou quando, por exemplo no IBM-PC, trabalhamos com os 128 caracteres adicionais da tabela ASCII, pois neste tipo de dado, trabalhamos com o código do símbolo na base hexadecimal.

É bastante comum erros de compilação por causa da sensitividade de C++, mas esse não é um erro difícil de se corrigir.