21 - Organização de Código

Ao terminar a leitura do capitulo 20, você já deve ter uma ótima noção de programação.

Todas as linguagens usam IF, FOR, arrays e ponteiros.. principalmente funções.
Por isso não interessa muito em qual linguagem você está programando, e sim, o que você sabe fazer com ela.

Se você está lendo a biblioteca, você com certeza já escreveu algum código em C++ para treinar sua programação e sua forma de pensar.

Antes de sair por ai programando jogos, precisamos ter uma certa organização do código fonte dos programas, para que consigamos ler o mesmo código algum outro dia.

Para organizar o código você precisa seguir regras fundamentais e obrigatórias.

Declarando variáveis

1 - Ao declarar variáveis, você deve tomar cuidado para não agrupar uma linha muito grande de variáveis.
Utilize sempre várias linhas, dando um enter entre os tipos de variáveis.

Exemplo totalmente errado que não deve ser usado:

int a, b, c, valor, numero, xab, contador, teste, coisa;
int a = 10, b, c, d=15, valor, coisa, variavel21, contador=0;

int numero_jogadores, posicao_peca_x, vari;

Exemplo correto:

int a = 0;
int b = 0;

int valor = 0;
int xab   = 0;

int numero_jogadores = 0;

int posicao_peca_x = 0;

2 - Observe sempre de separar com espaços variáveis que não combinam com as de cima
( por exemplo, posicionamento de peças com números de jogadores ).
Isto torna a leitura mais fácil.

3 - Sempre inicie as variáveis.

4 - Sempre deixe espaços ao iniciar as variáveis

Exemplo totalmente errado que não deve ser usado:

int a=0;b=30;

Exemplo correto:

int a = 0;
int b = 30;

5 - Ao iniciar as variáveis, mantenha uma ordem nas atribuições;

Exemplo totalmente errado que não deve ser usado:

int aviao = 0;
int posicao_x = 0;
int posi = 0;

Exemplo correto:

int aviao      = 0;
int posicao_x  = 0;
int posi       = 0;

Usando o exemplo acima, variáveis que tem nome menor ficam longe das que tem nome maior
Isso mantem o código ainda mais organizado

Exemplo totalmente errado que não deve ser usado:

int aviao = 0;
int b=0;
int posicao_x = 0;
int x=0;
int posi = 0;

Exemplo correto:

int aviao      = 0;
int posicao_x  = 0;
int posi       = 0;

int b = 0;
int a = 0;

6 - Tente sempre escrever o nome da variável por exemplo, usando o separador _.
Se não for possível, digite um comentário sobre o que a variável faz;

Exemplo totalmente errado que não deve ser usado:

int pos_per;
int px;
int py;

Exemplo correto:

int posicao_personagem;
int personagem_px; // posição x do personagem;
int personagem_py; // posicao y do personagem;

7 - Mantenha distancia em números na hora das operações matemáticas.
Utilize mais variáveis para ajudar nas operações, de forma que a operação fique fácil de ler

Exemplo totalmente errado que não deve ser usado:

int num=0;
num = 10*(4/2*(3-1));

Exemplo correto:

int num      = 0;
int auxiliar = 0;

auxiliar = ( ( 4 / 2 ) * ( 3- 1 ) );
num      = 10 * auxiliar;

8 - IMPORTANTE: Indentar sempre os códigos com extruturas de controle.

Exemplo totalmente errado que não deve ser usado:

if(a==1){ ....... }

while (ab!=true) {
....
}

for (i=0;i<10;i++) {
....
}

Todas as 3 formas acima estão erradas

Exemplo correto:

// Observe os espaços no parenteses, e use sempre a quebra de linha com a identação
if ( a == 1 )
{
      ........
}

while ( ab != true )
{
       // nunca abra as chaves na linha de cima
       ......
}

// observe os espaços entre os parametros do for
for ( i=0; i<10; i++ )
{
      .....
}

9 - Cuidar da identação quando o código for muito grande

Exemplo totalmente errado que não deve ser usado:
( exemplo com código maior ilustrativo, você nao precisa entender o que está escrito )

bool selecao_direta( fila *pprimeiro ) {
fila *proximo,*atual,*menor;
int chave;
while (pprimeiro != NULL) {
   proximo=(*pprimeiro).proximo;
   atual=pprimeiro;
   menor=atual;

  while ( proximo != NULL )
  {
     if ( (*proximo).numero<(*menor).numero)      
     menor=proximo;
     
     proximo=proximo->proximo;
  }
  
  chave = atual->numero;
  atual->numero = menor->numero;
  menor->numero = chave;
  pprimeiro = pprimeiro->proximo;
}
return true;
}

Exemplo correto:

bool selecao_direta( fila *pprimeiro )
{

  fila *proximo, *atual, *menor;

  int chave;

  while ( pprimeiro != NULL )
  {
      proximo  = (*pprimeiro).proximo;
      atual    = pprimeiro;
      menor    = atual;

      while ( proximo != NULL )
      {
        
          // nesse caso é muito importante usar as chaves " { } " e identar o if
          if ( (*proximo).numero < (*menor).numero )
          {
              menor = proximo;
          }

         proximo = proximo->proximo;
      }

      chave = atual->numero;
      atual->numero = menor->numero;
      menor->numero = chave;

      pprimeiro = pprimeiro->proximo;
  }

  return true;
}

10 - Não utilizar o comando Do While
O comando do while deixa as linguas de programação confusas, por isso, não é interessante utilizar

Qualquer código em qualquer linguagem pode ser escrito seguido essas observações importantes.