Perguntas com a marcação «readability»

Como saber se o código criado é facilmente legível, compreensível e sustentável? Obviamente, do ponto de vista do autor, o código é legível e sustentável, porque o autor o escreveu e o editou, para começar. No entanto, deve haver um padrão objetivo e quantificável pelo qual nossa profissão possa medir …

336 code-quality  code-reviews  readability  maintainability 

Meu chefe continua mencionando indiferentemente que maus programadores usam breake continueem loops. Eu os uso o tempo todo porque fazem sentido; deixe-me mostrar a inspiração: function verify(object) { if (object->value < 0) return false; if (object->value > object->max_value) return false; if (object->name == "") return false; ... } O ponto …

191 coding-style  language-agnostic  syntax  readability  control-structures 

Todos os programadores parecem concordar que a legibilidade do código é muito mais importante do que as one-liners de sintaxe curta que funcionam, mas exigem que um desenvolvedor sênior interprete com algum grau de precisão - mas essa parece ser exatamente a maneira como as expressões regulares foram projetadas. Havia …

160 readability  regular-expressions 

Geralmente, uso métodos privados para encapsular a funcionalidade que é reutilizada em vários locais da classe. Mas, às vezes, tenho um método público grande que pode ser dividido em etapas menores, cada uma em seu próprio método privado. Isso tornaria o método público mais curto, mas estou preocupado que forçar …

139 coding-style  readability 

Quando escrevo código, tento sempre torná-lo o mais limpo e legível possível. De vez em quando chega um momento em que você precisa cruzar a linha e passar de um bom código limpo para um pouco mais feio para torná-lo mais rápido. Quando é bom cruzar essa linha?

67 performance  optimization  quality  readability  maintainability 

Então, olhando ao redor mais cedo, notei alguns comentários sobre métodos longos serem uma prática ruim. Não tenho certeza se sempre concordo que métodos longos são ruins (e gostariam da opinião de outras pessoas). Por exemplo, eu tenho algumas visualizações do Django que processam um pouco os objetos antes de …

64 readability  methods 

O que é mais fácil de entender, uma grande declaração booleana (bastante complexa) ou a mesma declaração dividida em métodos predicados (muito código extra para ler)? Opção 1, a grande expressão booleana: private static bool ContextMatchesProp(CurrentSearchContext context, TValToMatch propVal) { return propVal.PropertyId == context.Definition.Id && !repo.ParentId.HasValue || repo.ParentId == propVal.ParentId …

63 c#  readability 

Ao revisar meu código aqui,const surgiu a questão do uso da palavra - chave. Entendo que é usado para implementar o comportamento somente leitura em variáveis. Estou confuso sobre quais são as várias situações em que pode ser útil. Deve ser usado por uma questão de clareza nos protótipos de …

58 c  readability  patterns-and-practices  const 

Meu estilo de codificação para chamadas de função aninhadas é o seguinte: var result_h1 = H1(b1); var result_h2 = H2(b2); var result_g1 = G1(result_h1, result_h2); var result_g2 = G2(c1); var a = F(result_g1, result_g2); Recentemente, mudei para um departamento em que o seguinte estilo de codificação é muito utilizado: var …

57 c#  c++  coding-style  readability  maintainability 

O consenso parece ser que se deve seguir a convenção da plataforma para a qual eles estão desenvolvendo. Vejo: Sublinhado ou camelcase? Convenções de nomenclatura: camelCase versus underscore_case? No entanto, o PHP parece não seguir estritamente nenhuma convenção internamente (sem surpresas), mesmo para métodos e funções (por exemplo mysqli::set_local_infile_default, PDOStatement::debugDumpParams); …

51 php  naming  readability  camelcase 

Frequentemente, vejo códigos que incluem erros ortográficos intencionais de palavras comuns que, para o bem ou para o mal, se tornaram palavras reservadas: klassou clazzpara aula :Class clazz = ThisClass.class kountpara contagem no SQL:count(*) AS kount Pessoalmente, acho que isso diminui a legibilidade. Na minha própria prática, não encontrei muitos …

45 coding-style  variables  readability  naming 

Freqüentemente, quando a sintaxe do idioma exigir que eu cite uma variável que nunca é usada, eu o nomeei _. Na minha opinião, isso reduz a desordem e me permite focar nas variáveis ​​significativas no código. Acho que é discreto e produz um efeito "fora da vista, fora da mente". …

44 language-agnostic  naming  readability  variables 

Fico confuso com as funções min e max, em certos contextos. Em um contexto, quando você está usando as funções para obter o maior ou o menor de dois valores, não há problema. Por exemplo, //how many autographed CD's can I give out? int howManyAutographs(int CDs, int Cases, int Pens) …

40 design  functions  readability 

Ao usar o encadeamento de métodos, como: var car = new Car().OfBrand(Brand.Ford).OfModel(12345).PaintedIn(Color.Silver).Create(); pode haver duas abordagens: Reutilize o mesmo objeto, assim: public Car PaintedIn(Color color) { this.Color = color; return this; } Crie um novo objeto do tipo Cara cada etapa, como este: public Car PaintedIn(Color color) { var car …

37 coding-style  readability  method-chaining 

Você deve sacrificar a legibilidade do código com a eficiência do código? por exemplo, 3 linhas de código em 1 linha. Li no Code Craft de Pete Goodliffe que a legibilidade é a chave. Seus pensamentos?

37 code-quality  performance  optimization  readability