Wiki
Convenção desenvolvedor/Convenção código/Espaçamento
Table of Contents [-]
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);
1925 Visualizações