«naming» etiketlenmiş sorular

Orada kullanılan çok / talimat tutmak için iyi nedenler kısa adları. Bu nedenler artık geçerli değil, ancak kısa şifreli isimler düşük seviyeli programlamada hala çok yaygın. Bu neden? Eski alışkanlıkların kırılması zor olduğu için mi yoksa daha iyi sebepler mi var? Örneğin: Atmel ATMEGA32U2 (2010?): TIFR1( Yerine TimerCounter1InterruptFlag), ICR1H(yerine InputCapture1High), …

64 naming  coding-standards  low-level 

Sınıf isimleri için tekil ve çoğul formlar arasında seçim yapmak her zaman zor CustomerRepository vs. CustomersRepository CustomerService vs. CustomersService CustomerController vs. CustomersController Ve bileşik isimler için daha da zor: SiparişMüşteri siparişiMüşteri siparişiMüşteri siparişiMüşteri siparişiMüşteri siparişi Hangi yaklaşımı tercih edersiniz ve neden?

58 naming  source-code 

Boole döndüren bir yöntem için daha iyi ad hangisidir? IsSupportContentType veya CanSupportContentType

51 naming  naming-standards 

Mutabakata varmak için geliştirdikleri platformun konvansiyonunu izlemesi gerektiği görünüyor. Görmek: Alt çizgi mi, camelcase mi? Adlandırma kuralları: camelCase vs. underscore_case? Ancak PHP, yöntemler ve işlevler için bile (örn mysqli::set_local_infile_default. PDOStatement::debugDumpParams) İçsel olarak herhangi bir sözleşmeyi (orada sürprizler yok) kesinlikle takip ediyor gibi görünmüyor ; ancak işlev adlarında alt çizgi baskın …

51 php  naming  readability  camelcase 

isBoole değişkenleri için her zaman önek olarak mı kullanmalıyım ? Geçmişte bir şey gösteren booleans ne olacak? Ben yazsak isInitializedya wasInitialized? Ben özellikleri için yazsak IsManyMembersya HasManyMembers? En iyi uygulamalar var mı? Yoksa sadece İngilizce kurallarına uygun olarak mı yazmalıyım?

49 coding-style  naming  boolean 

Genel rehberlikle bir köşe problemiyle karşılaştım: değişkenler için isimler fonksiyonlar için fiiller Özellikle, kelimenin belirsiz olduğu bir durum var - bu bir fiil veya bir isim olabilir. Bazı durumlarda, uygulamayı tartışırken , aynı cümleyle her iki şekilde de kullanılacaktır . Niyetim, aylar sonra kod bölümlerine döndüğümde programın gelecekteki geliştiricilerin yanı …

48 naming  variables 

getSomethingVersus ile başlayan belli bir yöntemi isimlendirmem gerekip gerekmediğini anlamakta her zaman sorun yaşarım findSomething. Sorun , iyi tasarlanmamış API'ler için yardımcıların oluşturulmasında yatmaktadır . Bu genellikle, nesneyi parametre olarak gerektiren bir nesneden veri alınırken oluşur. İşte basit bir örnek: public String getRevision(Item item) { service.load(item, "revision"); // there is …

48 naming  methods 

Sık sık, daha iyi veya daha kötüsü için ayrılmış sözcükler haline gelen, genel kelimelerin kasıtlı yanlış hecelemelerini içeren bir kod görüyorum: klassya clazziçin sınıfta :Class clazz = ThisClass.class kountSQL'de sayım için :count(*) AS kount Şahsen ben bu okunabilirliği azaltır buluyorum. Kendi uygulamamda daha iyi bir ismin kullanılamayacağı çok fazla dava …

45 coding-style  variables  readability  naming 

Genellikle, dilin sözdizimi, hiç kullanılmamış bir değişkeni ismemi istediğinde, onu isimlendiririm _. Aklımda bu karmaşayı azaltır ve koddaki anlamlı değişkenlere odaklanmama izin verir. Göze çarpmayan, böylece “görüş dışı, akıl dışı” bir etki yarattığını görüyorum. Bunu yaptığım yerin yaygın bir örneği, SQL'deki alt sorguları adlandırmaktır. SELECT * FROM ( SELECT * …

44 language-agnostic  naming  readability  variables 

Bir yöntemin döndürdüğü değişken ismini değişken ismiyle çağırmak iyi bir uygulama mıdır result? Örneğin: public Zorglub calculate() { Zorglub result = [...] [...] return result; } Yoksa türüne göre adlandırmalı mıyım? public Zorglub calculate() { Zorglub zorglub = [...] [...] return zorglub; } Her ikisini de vahşi doğada gördüm, birini …

44 programming-practices  naming  variables 

Boolean metotları sadece negatif formda kullanılsalar bile, her zaman olumlu bir formda olmalı mı? Bir varlık oluşturmadan önce var olup olmadığını kontrol etmek istediğimi söyleyin, argümanım, aşağıdaki ilk formun, ikinci formdan daha iyi olduğunu, yöntemin olumlu formda kullanılıp kullanılmadığını belirtmek. Özet olarak, if(!affirmative)okumaktan daha kolay buluyorum if(negative). Düşünceme katılmayan bir …

43 naming  functions 

Aşağıdakilerle ne yapacağımdan emin değilim: Kendi aracımızdaki verileri harici bir araçtan alıyoruz. Bu veri Hollandaca yazılmıştır. Java kodumuzu İngilizce olarak yazıyoruz. Bu Hollandalıyı İngilizceye mi çevirmeliyiz yoksa Hollandalı olarak mı tutacağız? Örneğin, 2 departmanımız var: Bouw (İngilizce olarak inşaat) ve Onderhoud (İngilizce olarak bakım). Daha sonra oluşturmak için mantıklı olurdu: …

39 naming  translate 

Şirin isimlendirme terimini buradan çektim (sayı 21). Sorun tanıdık değil kimseyi kurtarmak için, "Bir ile bitirmek böylece, Şirin adlandırma ortak bir önek ile ilgili sınıflar, değişkenler, vb bir demet prefixing eylemidir SmurfAccountViewbir geçer SmurfAccountDTOiçin SmurfAccountController" vb Buna genel olarak duyduğum çözüm, bir şirin ad alanı yapmak ve şirin önekleri bırakmaktır. …

39 naming  coding-standards 

Yöntemlerin yalnızca argüman adıyla (tür değil) ayırt edilmesi yeterli mi yoksa daha açık bir şekilde adlandırılması daha mı iyi? Örneğin T Find<T>(int id)vs T FindById<T>(int id). ByIdSadece argüman adını tutmak vs daha açık bir şekilde adlandırmak için herhangi bir iyi sebep var mı ? Düşünebilmemin bir nedeni, yöntemlerin imzalarının aynı …

36 c#  naming  coding-standards  conventions  method-overloading 

Bazı isimler var, bu isimlere ulaşmak için kendinizi bulursanız, zaten bir şeyi batırdığınızı bilirsiniz. Örneğin: XxxManager Bu kötü, çünkü bir sınıf, sınıfın ne yaptığını tanımlamalıdır. Sınıfın ne yaptığıyla ilgili olarak bulabileceğiniz en belirgin kelime "yönetmek" ise, sınıf çok büyüktür. Başka ne adlandırma karşıtı paternler var? Açıklığa kavuşturmak için, "hangi adların …

35 naming  anti-patterns