Wiki

Convenção desenvolvedor/Convenção código/Espaçamento

(Redirecionado de Convenção desenvolvedor/Convenção código/Espacamento)

Espaçamento #

Linhas em branco #

Linhas em branco melhoram a leitura do código, uma vez que através delas são definidas seções de código relacionadas logicamente.

Duas linhas em branco deverão ser sempre usadas nas seguintes circunstâncias:

  • entre seções de um arquivo fonte;
  • entre declarações de classes e interfaces.

Uma linha em branco deverá sempre ser usada nas seguintes circunstâncias:

  • entre métodos;
  • entre variáveis locais em um método e sua primeira instrução;
  • antes de um bloco ou de um comentário simples;
  • entre seções lógicas dentro de um método para melhorar a leitura.

Espaços em branco #

Espaços em branco deverão ser usados nas seguintes circunstâncias:

  • Uma palavra chave seguida de parênteses deverá ser separada por um espaço. Exemplo:
while (true) { 
    . . . 
}

Note que um espaço em branco não deve ser usado entre o nome de um método e o parêntese que será aberto. Isto ajuda a distinguir as chaves da chamada de um método.

  • Um espaço em branco deverá aparecer depois de vírgulas em listas de argumentos.
  • Todos os operadores binários exceto “.” deverão ser separados de seus operandos por espaços. Espaços em branco nunca deverão aparecer entre operadores unários, tais como o operador unário “-” de inversão de sinal, ou os operadores de incremento “++” e de decremento “—“. Exemplos:
a += c + d; 

a = (a + b) / (c * d); 

while (d++ = s++) { 
    n++; 
} 

println("o tamanho é " + tam + "\n");
  • As expressões dentro de uma instrução “for” deverão ser separadas por espaços em branco. Exemplo:
for (expr1; expr2; expr3)
  • Operadores de conversão (cast) deverão ser seguidos por um espaço em branco. Exemplo:
meuMetodo((byte) num, (Object) x); 

minhaFuncao((int) (cp + 5), ((int) (i + 3)) + 1);
0 Anexos
1924 Visualizações
Média (0 Votos)
A média da avaliação é 0.0 estrelas de 5.
Comentários
Sem comentários ainda. Seja o primeiro.