Convenção desenvolvedor/Convenção código/Instruções 1.1 (Edição mínima)

2013-01-09T20:00:05Z

Linha 1

<<TableOfContents>>

Linha 2

Linha 3

== Instruções ==

Linha 4

Linha 5

=== Instruções simples ===

Linha 6

Linha 7

Cada linha deverá conter no máximo uma instrução. Exemplos:

Linha 8

Linha 9

}

Linha 10

Linha 11

=== Instruções compostas ===

Linha 12

Linha 13

Instruções compostas são instruções que possuem uma lista de instruções contidas

Linha 14

entre chaves, isto é, no bloco delimitado por “{” e “}”. Veja alguns exemplos nas sessões

Linha 15

seguintes.

Linha 16

Linha 17

Eis algumas regras a serem seguidas no que tange as instruções compostas:

Linha 18

* instruções contidas no bloco devem ser indentadas em um ou mais níveis além do início da instrução composta;

Linha 19

* a chave aberta “{“ deve estar no final da linha onde se inicia a instrução composta, e a chave fechada “}” deve começar em uma linha indentada com o início da instrução composta;

Linha 20

* as chaves são usadas ao redor de todas as instruções, exceto para instruções simples, quando elas são partes de uma estrutura de controle, tais como uma instrução if-else ou for. Isso faz com que seja mais fácil incluir instruções sem a introdução acidental de bugs acidentais por se esquecer de se abrir as chaves.

Linha 21

Linha 22

=== Instruções de retorno ===

Linha 23

Linha 24

A instrução return com um valor não deverá usar parênteses a menos que este valor

Linha 25

torne-se mais claro com o uso destes. Eis alguns exemplos:

Linha 26

Linha 27

}

Linha 28

Linha 29

}

Linha 30

Linha 31

}

Linha 32

Linha 33

=== Instruções condicionais “if” ===

Linha 34

Linha 35

A classe de instruções condicionais “if-else” deverá utilizar uma das seguintes formas:

Linha 36

Linha 37

}

Linha 38

Linha 39

}

Linha 40

Linha 41

}

Linha 42

Linha 43

As instruções condicionais do tipo “if” devem sempre utilizar chaves {}. Evite usar a seguinte forma propensa a erros:

Linha 44

Linha 45

}

Linha 46

Linha 47

=== Instruções de repetição “for” ===

Linha 48

Linha 49

Uma instrução de repetição do tipo “for” deverá ter a seguinte forma:

Linha 50

Linha 51

}

Linha 52

Linha 53

Quando utilizar o operador vírgula na cláusula de inicialização ou iteração de uma

Linha 54

instrução “for”, evite usar mais de três variáveis. Se necessário, use instruções em separado

Linha 55

antes do laço “for” (para a cláusula de inicialização) ou ao final do loop (para a cláusula de

Linha 56

iteração).

Linha 57

Linha 58

=== Instruções de repetição “while” ===

Linha 59

Linha 60

Uma instrução de repetição do tipo “while” deverá ter a seguinte forma:

Linha 61

Linha 62

}

Linha 63

Linha 64

=== Instruções de repetição “do-while” ===

Linha 65

Linha 66

Uma instrução de repetição do tipo “do-while” deverá ter a seguinte forma:

Linha 67

Linha 68

}

Linha 69

Linha 70

=== Instruções condicionais “switch” ===

Linha 71

Linha 72

Uma instrução condicional do tipo “switch” deverá utilizar a seguinte forma:

Linha 73

Linha 74

}

Linha 75

Linha 76

Toda vez que houver um caso em que ocorra falsa passagem, isto é, quando não

Linha 77

houver a instrução break, inclua um comentário justificando essa abordagem justamente

Linha 78

onde o break deveria estar. De qualquer forma, sempre que possível evite utilizar a falsa

Linha 79

passagem.

Linha 80

Linha 81

Toda instrução switch deverá apresentar um caso padrão através da cláusula default.

Linha 82

O uso do break em uma instrução default é redundante, porém previne erros de falsas

Linha 83

passagens se outra instrução case for adicionada ao final.

Linha 84

Linha 85

=== Instruções de tratamento de exceção “try-catch” ===

Linha 86

Linha 87

Uma instrução do tipo “try-catch” deverá ter o seguinte formato:

Linha 88

Linha 89

}

Linha 90

Linha 91

Uma instrução do tipo “try-catch” também pode ser seguida da instrução “finally”:

Linha 92

Linha 93

}

Linha 94

Linha 1

~~New~~

Convenção desenvolvedor/Convenção código/Instruções 1.2 (Edição mínima)

2013-01-09T20:00:05Z

Convenção desenvolvedor/Convenção código/Instruções 1.3 (Edição mínima)

2013-01-09T20:00:05Z

Convenção desenvolvedor/Convenção código/Instruções 1.4

2013-04-05T16:20:42Z

Linha 4

== Instruções ==

Linha 9

}

Linha 9

{{{

argv++; // correto

argc++; // correto

argv++; argc--; // evitar!

}}}

Linha 22

Linha 24

Linha 27

}

Linha 35

{{{

return;

return meuDisco.calcularTamanho();

return (tamanho != null ? tamanho : tamanhoPadrao);

}}}

Linha 48

{{{

if (condição) {

instruções;

Linha 53

Linha 54

if (condição) {

Linha 55

instruções;

Linha 56

} else {

Linha 57

instruções;

Linha 38

Linha 59

Linha 60

if (condição) {

Linha 61

instruções;

Linha 62

} else if (condição) {

Linha 63

instruções;

Linha 64

} else if (condição) {

Linha 65

instruções;

Linha 66

} else {

Linha 67

instruções;

Linha 40

Linha 69

}}}

Linha 71

Linha 45

}

Linha 76

{{{

if (condição) // evite omitir as chaves neste caso!

instrução;

}}}

Linha 86

{{{

for (inicialização; condição; iteração) {

instruções;

Linha 91

}}}

Linha 93

Linha 104

{{{

while (condição) {

instruções;

Linha 109

}}}

Linha 111

Linha 68

}

Linha 117

{{{

do {

instruções;

} while (condição);

}}}

Linha 128

{{{

switch (variável) {

case ABC:

instruções;

/* falsa passagem */

case DEF:

instruções;

break;

case XYZ:

instruções;

break;

default:

instruções;

break;

Linha 144

}}}

Linha 146

Linha 153

Linha 162

{{{

try {

instruções;

} catch (ClasseException e) {

instruções;

Linha 169

}}}

Linha 171

Linha 93

}

Linha 176

{{{

try {

instruções;

} catch (ClasseException e) {

instruções;

} finally {

instruções;

}

}}}