Pertanyaan yang diberi tag «naming»

Dulu ada alasan yang sangat baik untuk menjaga instruksi / daftar nama pendek. Alasan itu tidak lagi berlaku, tetapi nama samar pendek masih sangat umum dalam pemrograman tingkat rendah. Kenapa ini? Apakah hanya karena kebiasaan lama sulit dihilangkan, atau adakah alasan yang lebih baik? Sebagai contoh: Atmel ATMEGA32U2 (2010?): TIFR1(Bukan …

64 naming  coding-standards  low-level 

Selalu sulit bagi saya untuk memilih antara bentuk tunggal dan jamak untuk nama kelas: CustomerRepository vs. CustomersRepository CustomerService vs. CustomersService CustomerController vs. CustomersController Dan untuk nama gabungan itu bahkan lebih sulit: OrderCustomerRepository vs. OrderCustomersRepository vs OrdersCustomersRepository Pendekatan apa yang Anda sukai dan mengapa?

58 naming  source-code 

Tampaknya konsensus adalah bahwa seseorang harus mengikuti konvensi platform yang mereka kembangkan. Lihat: Garis bawah atau unta? Konvensi penamaan: camelCase versus underscore_case? Namun, PHP tampaknya tidak secara ketat mengikuti konvensi apa pun secara internal (tidak ada kejutan di sana), bahkan untuk metode dan fungsi (misalnya mysqli::set_local_infile_default, PDOStatement::debugDumpParams); Namun, garis bawah …

52 php  naming  readability  camelcase 

Yang mana nama yang lebih baik untuk metode yang mengembalikan boolean? IsSupportContentType atau CanSupportContentType

51 naming  naming-standards 

Haruskah saya selalu menggunakan isawalan untuk variabel boolean? Bagaimana dengan boolean yang menunjukkan sesuatu di masa lalu? Haruskah saya menulis isInitializedatau wasInitialized? Haruskah saya menulis untuk properti IsManyMembersatau HasManyMembers? Apakah ada praktik terbaik? Atau saya harus menulis sesuai dengan aturan bahasa Inggris?

50 coding-style  naming  boolean 

Saya mengalami masalah sudut dengan pedoman umum: kata benda untuk variabel kata kerja untuk fungsi Secara khusus, saya memiliki kasus di mana kata tersebut ambigu - bisa berupa kata kerja atau kata benda. Dan dalam beberapa kasus ketika kita membahas aplikasi, itu akan digunakan dua arah dalam kalimat yang sama. …

48 naming  variables 

Saya selalu mengalami kesulitan mencari tahu apakah saya harus menyebutkan metode tertentu dimulai dengan getSomethingversus findSomething. Masalahnya terletak pada pembuatan pembantu untuk API yang dirancang dengan buruk. Ini biasanya terjadi ketika mendapatkan data dari suatu objek, yang membutuhkan objek sebagai parameter. Ini adalah contoh sederhana: public String getRevision(Item item) { …

48 naming  methods 

Saya sering melihat kode yang menyertakan kesalahan ejaan kata-kata umum yang disengaja menjadi lebih baik atau lebih buruk: klassatau clazzuntuk kelas :Class clazz = ThisClass.class kountuntuk hitungan dalam SQL:count(*) AS kount Secara pribadi saya menemukan ini mengurangi keterbacaan. Dalam praktik saya sendiri, saya belum menemukan terlalu banyak kasus di mana …

45 coding-style  variables  readability  naming 

Seringkali ketika sintaks bahasa mengharuskan saya untuk memberi nama variabel yang tidak pernah digunakan, saya akan menyebutkannya _. Dalam pikiran saya, ini mengurangi kekacauan dan membuat saya fokus pada variabel yang berarti dalam kode. Saya menemukan itu tidak mengganggu sehingga menghasilkan efek "tidak terlihat, keluar dari pikiran". Contoh umum di …

44 language-agnostic  naming  readability  variables 

Apakah praktik yang baik untuk memanggil variabel metode kembali dengan nama variabel result? Misalnya: public Zorglub calculate() { Zorglub result = [...] [...] return result; } Atau haruskah saya beri nama berdasarkan jenisnya? public Zorglub calculate() { Zorglub zorglub = [...] [...] return zorglub; } Saya telah melihat keduanya di …

44 programming-practices  naming  variables 

Haruskah metode boolean selalu mengambil bentuk afirmatif, bahkan ketika mereka hanya akan digunakan dalam bentuk negatif? Katakanlah saya ingin memeriksa apakah suatu entitas ada sebelum membuat entitas, argumen saya adalah bahwa bentuk pertama di bawah ini lebih baik daripada bentuk kedua, apakah metode tersebut pernah digunakan dalam bentuk afirmatif atau …

44 naming  functions 

Saya tidak yakin apa yang harus dilakukan dengan hal berikut: Kami mengambil data dari alat eksternal di dalam alat kami sendiri. Data ini ditulis dalam bahasa Belanda. Kami sedang menulis kode Java kami dalam bahasa Inggris. Haruskah kita menerjemahkan bahasa Belanda ini ke bahasa Inggris atau tetap menggunakan bahasa Belanda? …

39 naming  translate 

Saya menarik istilah penamaan smurf dari sini (nomor 21). Untuk menyelamatkan siapa pun yang tidak mengenal masalahnya, penamaan Smurf adalah tindakan prefixing sekelompok kelas terkait, variabel, dll dengan awalan umum sehingga Anda berakhir dengan "a SmurfAccountViewpass a SmurfAccountDTOto the SmurfAccountController", dll. Solusi yang umumnya saya dengar adalah membuat namespace smurf …

39 naming  coding-standards 

Apakah cukup untuk metode dibedakan hanya dengan nama argumen (bukan tipe) atau lebih baik untuk nama lebih eksplisit? Misalnya T Find<T>(int id)vs T FindById<T>(int id). Apakah ada alasan yang baik untuk menamainya lebih eksplisit (yaitu menambahkan ById) vs mempertahankan nama argumen yang adil? Salah satu alasan yang bisa saya pikirkan …

36 c#  naming  coding-standards  conventions  method-overloading 

Ada beberapa nama, di mana jika Anda menemukan diri Anda meraih nama-nama itu, Anda tahu Anda telah mengacaukan sesuatu. Sebagai contoh: XxxManager Ini buruk karena kelas harus menjelaskan apa yang dilakukan kelas. Jika kata paling spesifik yang dapat Anda temukan untuk apa yang dikerjakan kelas adalah "kelola," maka kelas itu …

35 naming  anti-patterns