Pertanyaan yang diberi tag «readability»

Bagaimana orang tahu jika kode yang telah dibuat mudah dibaca, dimengerti, dan dipelihara? Tentu saja dari sudut pandang penulis, kode dapat dibaca dan dipelihara, karena penulis menulis dan mengeditnya, untuk memulai. Namun, harus ada standar objektif dan terukur yang digunakan oleh profesi kita untuk mengukur kode. Tujuan-tujuan ini terpenuhi ketika …

336 code-quality  code-reviews  readability  maintainability 

Bos saya terus menyebutkan dengan acuh tak acuh bahwa programmer buruk menggunakan breakdan continuedalam loop. Saya menggunakannya sepanjang waktu karena mereka masuk akal; izinkan saya menunjukkan inspirasi kepada Anda: function verify(object) { if (object->value < 0) return false; if (object->value > object->max_value) return false; if (object->name == "") return false; …

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

Semua programmer tampaknya setuju bahwa keterbacaan kode jauh lebih penting daripada one-liner sintaksis pendek yang berfungsi, tetapi membutuhkan pengembang senior untuk menginterpretasikan dengan tingkat keakuratan apa pun - tetapi tampaknya seperti cara ekspresi reguler dirancang. Apakah ada alasan untuk ini? Kita semua sepakat bahwa selfDocumentingMethodName()itu jauh lebih baik daripada e(). …

160 readability  regular-expressions 

Secara umum saya menggunakan metode pribadi untuk merangkum fungsionalitas yang digunakan kembali di banyak tempat di kelas. Tetapi kadang-kadang saya memiliki metode publik besar yang dapat dipecah menjadi langkah-langkah yang lebih kecil, masing-masing dengan metode pribadi. Ini akan membuat metode publik lebih pendek, tetapi saya khawatir bahwa memaksa siapa pun …

139 coding-style  readability 

Ketika saya menulis kode, saya selalu berusaha membuat kode saya sebersih dan semudah mungkin dibaca. Kadang-kadang ada saatnya Anda harus melewati batas dan beralih dari kode bersih yang bagus ke kode yang sedikit lebih buruk untuk membuatnya lebih cepat. Kapan boleh melewati batas itu?

67 performance  optimization  quality  readability  maintainability 

Jadi melihat-lihat sebelumnya saya perhatikan beberapa komentar tentang metode panjang menjadi praktik yang buruk. Saya tidak yakin saya selalu setuju bahwa metode panjang itu buruk (dan ingin pendapat dari orang lain). Sebagai contoh, saya memiliki beberapa pandangan Django yang melakukan sedikit pemrosesan objek sebelum mengirimnya ke tampilan, metode yang panjang …

64 readability  methods 

Apa yang lebih mudah dipahami, pernyataan boolean besar (cukup kompleks), atau pernyataan yang sama dipecah menjadi metode predikat (banyak kode tambahan untuk dibaca)? Opsi 1, ekspresi boolean besar: private static bool ContextMatchesProp(CurrentSearchContext context, TValToMatch propVal) { return propVal.PropertyId == context.Definition.Id && !repo.ParentId.HasValue || repo.ParentId == propVal.ParentId && ((propVal.SecondaryFilter.HasValue && context.SecondaryFilter.HasValue …

63 c#  readability 

Sementara kode saya ditinjau di sini masalah penggunaan constkata kunci muncul. Saya mengerti bahwa ini digunakan untuk menerapkan perilaku read-only pada variabel. Saya bingung tentang berbagai situasi apa yang bisa bermanfaat. Haruskah digunakan demi kejelasan dalam prototipe fungsi? Haruskah itu digunakan sebagai langkah pengamanan selama pengembangan kode? Haruskah itu digunakan …

58 c  readability  patterns-and-practices  const 

Gaya pengkodean saya untuk panggilan fungsi bersarang adalah sebagai berikut: 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); Saya baru saja berubah menjadi departemen di mana gaya pengkodean berikut ini sangat banyak digunakan: var a = …

57 c#  c++  coding-style  readability  maintainability 

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 

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 

Saya bingung tentang fungsi min dan maks, dalam konteks tertentu. Dalam satu konteks, saat Anda menggunakan fungsi untuk mengambil dua nilai yang lebih besar atau lebih kecil, tidak ada masalah. Sebagai contoh, //how many autographed CD's can I give out? int howManyAutographs(int CDs, int Cases, int Pens) { //if no …

40 design  functions  readability 

Saat menggunakan metode chaining seperti: var car = new Car().OfBrand(Brand.Ford).OfModel(12345).PaintedIn(Color.Silver).Create(); mungkin ada dua pendekatan: Gunakan kembali objek yang sama, seperti ini: public Car PaintedIn(Color color) { this.Color = color; return this; } Buat objek jenis baru Cardi setiap langkah, seperti ini: public Car PaintedIn(Color color) { var car = new …

37 coding-style  readability  method-chaining 

Haruskah Anda mengorbankan keterbacaan kode dengan seberapa efisien kode itu? misal 3 baris kode menjadi 1 baris. Saya membaca di Code Craft oleh Pete Goodliffe bahwa keterbacaan adalah kuncinya. Pikiran Anda?

37 code-quality  performance  optimization  readability