The Game Makers Brasil

Enviado: **Qui Abr 28, 2016 11:14 pm**

Autor original: Carlos L.

Nome: Indentação.
Descrição: Uma breve descrição de como fazer um bom código.
Nível de Dificuldade: Iniciante.
Requerimentos: Qualquer coisa onde se possa escrever.

E a e pessoal, tudo bem, esse tutorial será breve (pelo menos eu acho), vou explicar como usar a indentação não só para uma boa estética mas também para uma boa leitura de seu código fonte.
A indentação e fundamental quando se trabalha em equipe, pois você terá que fazer um código onde todos de sua equipe possam entender o que está escrito, e não só você.
Muitas pessoa devem pensar ‘Para que fazer tudo arrumadinho não faz diferença.’, quando você começar a fazer coisas grandes além de bolas se mexendo você notará a diferença, disso você pode ter certeza.
Existem vários tipos de indentação não vou entrar em detalhes dos tipos somente dar uma breve explicação de como usar um estilo de indentação que considero o melhor que é o Estilo Allman, ele é bem simples vou demostrar uns exemplos e vocês notarão a diferença entre um código indentado e um não indentado.

Código: Selecionar todos

// SEM INDENTAÇÃO.
if (keyboard_check(vk_right)) {hspeed = velocidade;}
// OU 
if (keyboard_check(vk_right)) 
{
hspeed = velocidade;
}

// COM INDENTAÇÃO.
if (keyboard_check(vk_right))
{
   hspeed = 5;
}

Se você reparou bem você notou um breve espaçamento entre a condição e o que aquela condição executará se for verdade, mas, como o código e pequeno não faz tanta diferença, uma dica que posso dar para códigos pequenos e retirar as chaves e dar um pequeno espaçamento no código da seguinte maneira.

Código: Selecionar todos

if (keyboard_check(vk_right))
   hspeed = 5;

Assim fica bem mais organizado, não fica.
Agora para você 'chato' que deve estar pensando 'Aiai não vi diferença nenhuma seu noobão', eu vou lhe mostrar como a indentação exerce um papel importante na organização de um bom código preste atenção.

Código: Selecionar todos

// SEM INDENTAÇÃO.
if (voceEstaLendo == true){if (seuCodigo == Ruim){voceProgramaAssim = true
}else{voceProgramaAssim = false}}

Reparou que ele está horrível. Se você entregar um código assim para alguém não reclame se ele(a) lhe xingar e falar que não entendeu nada. Agora vamos ver o mesmo código com a indentação de Allman.

Código: Selecionar todos

// COM INDENTAÇÃO.
if (voceEstaLendo == true)
{
   if (seuCodigo == Ruim)
   {
       voceProgramaAssim = true;
   }
   else
   {
       voceProgramaAssim = false;
   }
}

Prestou atenção na diferença, esse tipo de indentação e superfácil.

Após cada chave e colocado um espaçamento onde esse espaçamento pode ser dado pressionando a tecla TAB.

Pronto era isso que queria passar pro pessoal, comecem a treinar um pouco o estilo como escreve seu código e você notará a diferença. Outra maneira de organiza-lo para quando se quiser localizar algo e colocando comentário, preste atenção comentário não um texto descrevendo o código, espero que o pessoal siga a dica.

OBS: Caso você queira saber mais sobre indentação olhe no Wikipedia mas em inglês porque o wikipedia com as matérias em português e uma vergonha.

The Game Makers Brasil

[PROG] [Carlos - Tutorial] Indentação.

[PROG] [Carlos - Tutorial] Indentação.