Odores e Heurísticas - Funções

Os principais pontos são:

• Tamanho Reduzido: Funções devem ser curtas, idealmente com poucas linhas, para facilitar a compreensão e manutenção.

• Fazer Apenas Uma Coisa: Cada função deve ter uma única responsabilidade bem definida. Se uma função faz mais de uma coisa, deve ser dividida em funções menores.

• Nomes Significativos: O nome da função deve descrever claramente sua finalidade, evitando abreviações e termos genéricos.

• Poucos Parâmetros: O ideal é que uma função tenha no máximo três parâmetros. Se houver mais, pode indicar a necessidade de refatoração, como a criação de um objeto.

• Evitar Efeitos Colaterais: Funções devem ser previsíveis e não alterar o estado de variáveis globais ou de objetos inesperadamente.

• Uso de Exceções ao Invés de Códigos de Retorno: O tratamento de erros deve ser feito com exceções bem definidas, tornando o código mais limpo.

• Estrutura Limpa: O código dentro da função deve ser lido como uma história, do nível mais alto de abstração para o mais detalhado.