«readability» etiketlenmiş sorular

Bu yöntemleri içeren bir arayüz olduğunu varsayın: Car find(long id); List<Car> find(String model); Bunları bu şekilde yeniden adlandırmak daha iyi mi? Car findById(long id); List findByModel(String model); Aslında, bu API'yı kullanan herhangi bir geliştiricinin, başlangıç find()yöntemlerinin olası argümanlarını bilmek için arayüze bakması gerekmez . Yani sorum daha genel: Okunabilirliği azalttığı …

14 design  naming  readability  method-overloading 

Son zamanlarda belirli bir projede belirli bir sınıf için zincirleme yönteminin uygulanmasını önerdim, böylece kodun okunabilirliği geliştirilebilir. Sadece kolaylık sağlamak için değil, anlambilim için de akıcı arayüzler uygulanmalı ve benim önerim reddedildi. Akıcı bir arayüz önermediğimi ama okunabilirliği ve kodlama konforunu iyileştirmek için kendini zincirleme yönteminin (her ikisi de birbiriyle …

14 architecture  coding-standards  readability  method-chaining 

Değerlerin doğrulanmasıyla ilgilenen bir sürü sınıfım var. Örneğin, bir RangeValidatorsınıf bir değerin belirtilen aralıkta olup olmadığını kontrol eder. Her validator sınıfı iki yöntem içerir: bu değer is_valid(value)döndürür Trueveya Falsedeğere bağlı olarak, ensure_valid(value)belirtilen değeri kontrol eder ve değer geçerliyse hiçbir şey yapmaz veya değer önceden tanımlanmış kurallarla eşleşmezse belirli bir istisna …

13 unit-testing  exceptions  readability 

Okunacak öğelerin sayısının bilinmediği bir okuyucu yinelemeniz gerektiğinde ve bunu yapmanın tek yolu, sonuna kadar okumaya devam etmektir. Bu genellikle sonsuz bir döngüye ihtiyacınız olan yerdir. Her zaman vardır trueki olmalı gösterir breakveya returndeyim yere bloğunun içinde. int offset = 0; while(true) { Record r = Read(offset); if(r == null) …

13 c#  code-quality  readability 

Çoğu programlama dilinde, değişkenlerin PHP'deki gibi tanımlayıcı karakterleri yoktur. PHP'de bir değişkenin $karakterin önüne eklenmesi gerekir . Misal; var $foo = "something"; echo $foo; Bir iş uygulaması için yeni bir komut dosyası dili geliştiriyorum ve hedef kullanıcılarımın programlama geçmişi yok. Bu karakterler kodu okumayı ve kullanmayı kolaylaştırıyor mu? PHP'nin kullanmasının …

13 programming-languages  readability 

Clojure'da yeniyim. Yazdığım kodu anlayabiliyorum ama daha sonra anlamak çok zor oluyor. Parantezleri eşleştirmek zorlaşır. Çeşitli durumlarda adlandırma kuralları ve girinti konusunda izlenecek genel kurallar nelerdir? Örneğin anlamak için örnek bir yapılanma örneği yazdım ama ikinci kez tamamen okunamaz görünüyor. (defn f [{x :x y :y z :z [a b …

13 readability  clojure 

Sadece oldukça uzun özellik adlarına sahip bir if ifadesi yazıyordum ve bu sorunla karşılaştım. Diyelim ki böyle bir if ifademiz var: if(_someViewModelNameThatIsLong.AnotherPropertyINeedToCheck == someValue && !_someViewModelNameThatIsLong.ThisIsABooleanPropertyThatIsImportant) { //Do something } İkinci özellik boolean tipindedir ve stetementin böyle olması mantıklı değildir if(boleanValue == true) Olumsuzluğu vurgulamak ve sonra öne koymak için …

13 readability 

Kapalı . Bu sorunun daha fazla odaklanması gerekiyor . Şu anda cevapları kabul etmiyor. Bu soruyu geliştirmek ister misiniz? Soruyu, yalnızca bu yayını düzenleyerek tek bir soruna odaklanacak şekilde güncelleyin . 2 yıl önce kapalı . Bunu merak ediyorum çünkü herhangi bir fonksiyonel dili öğrenmeden önce hatırlıyorum, hepsini korkunç, korkunç, …

13 object-oriented  functional-programming  readability 

Anladığım kadarıyla, sıralamalar [Flag]genellikle bireysel değerlerin birbirini dışlamadığı, birleştirilebilen şeyler için kullanılır . Örneğin: [Flags] public enum SomeAttributes { Foo = 1 << 0, Bar = 1 << 1, Baz = 1 << 2, } Burada herhangi bir SomeAttributesdeğeri bir kombinasyonu olabilir Foo, Barve Baz. Daha karmaşık, gerçek yaşam senaryosunda …

12 c#  .net  readability  enum 

Tek Sorumluluk İlkesini (SRP) izlemeye ve Kod Tekrarlarını atlamaya çalışıyorum. Bununla birlikte, genellikle kod tekrarlamalarının, en azından anlamlı bir yöntem olarak ayıklanmaya dirençli invokasyon blok bloklarından başka bir şey olmayan yerler vardır: DoAction1(); DoAction2(); if (value) DoAction3(); DoAction4(); Bu kodu bir yönteme çıkarmanın en iyi yolu nedir ve nasıl adlandırılır?

11 refactoring  readability  single-responsibility  code-reuse 

Geçenlerde Java'da geri dönüp birim testleri eklemek için orta ölçekli bir projenin yeniden düzenlenmesi işlemini yaptım. Singletonlar ve statiklerle alay etmenin ne kadar acı olduğunu fark ettiğimde, nihayet onlar hakkında okuduğum şeyi bu kez "aldım". (Deneyimden öğrenmesi gereken insanlardan biriyim. Oh iyi.) Şimdi, nesneleri oluşturmak ve onları birbirine bağlamak için …

11 coding-standards  readability  coding-style  static-methods 

Hangisi daha sürdürülebilir kabul edilir? if (a == b) c = true; else c = false; veya c = (a == b); Code Complete'e bakmayı denedim, ancak bir cevap bulamıyorum. İlkinin daha okunabilir olduğunu düşünüyorum (kelimenin tam anlamıyla yüksek sesle okuyabilirsiniz), ki bu da onu daha sürdürülebilir hale getiriyor. İkincisi …

11 .net  code-quality  readability  maintainability  clean-code 

Delphi'de bir proje çalışıyorum ve uygulama için bir yükleyici oluşturuyorum, üç ana bölüm var. PostgreSQL kurulum / kaldırma myapplication ( myapplication kurulumu nsi kullanılarak oluşturulur) yükleme / kaldırma. Komut dosyası aracılığıyla Postgres'de tablo oluşturma (toplu iş dosyaları). Her şey düzgün ve sorunsuz çalışır, ancak bir şey başarısız olursa, LogToFileger'ı oluşturdum …

11 code-quality  readability  logging 

Sanırım bu soru derhal öznel olarak işaretlenecek, ancak hangisinin daha iyi olduğunu düşünüyorsunuz: double volume(double pressure, double n_moles, double temperature) { return n_moles * BOLTZMANN_CONSTANT * temperature / pressure; } veya double volume(double P, double n, double T) { return n*R*T/P; } Başka bir deyişle, bazı denklemi uygulayan fonksiyonlar denklemin …

11 math  coding-style  readability 

Bunlardan hangisi sürdürülebilirlik için daha iyidir? if (byteArrayVariable != null) if (byteArrayVariable .Length != 0) //Do something with byteArrayVariable VEYA if ((byteArrayVariable != null) && (byteArrayVariable.Length != 0)) //Do something with byteArrayVariable Ben ikinci okuma ve yazma tercih, ama kod böyle bir şey yapmanın sürdürülebilirlik için kötü olduğunu tam okuma …

11 programming-practices  coding-standards  maintenance  readability