Запитання з тегом «coding-standards»

Я переглядав Правила кодування AvSol для C # і погоджуюся майже з усім, але мені дуже цікаво побачити, що інші думають про одне конкретне правило. AV1500 Методи не повинні перевищувати 7 тверджень Метод, який вимагає більше 7 тверджень, робить занадто багато або має занадто багато обов'язків. Він також вимагає від …

78 c#  coding-standards  maintainability 

Вам коли-небудь доводилося працювати над стандартами кодування, які: Значно знизили свою продуктивність? Спочатку вони були включені з поважних причин, але їх зберігали довго після того, як первісне занепокоєння стало неактуальним? Були в списку так довго, що неможливо було їх усіх запам'ятати? Змусили вас думати, що автор просто намагався залишити свій …

77 coding-standards  coding-style 

У мене склалося враження, що система контролю версій усунула необхідність скріплення "журналів змін" скрізь у коді. Я часто бачив постійне використання журналів змін, включаючи великі довгі блоки на початку збережених процедур з великим розділом, заблокованим для змін у файлі та засміченням коду такими речами, як: // 2011-06-14 (John Smith) Change …

75 version-control  coding-standards  maintenance 

Я читав " Чистий код " Роберта Мартіна, щоб сподіватися, що став кращим програмістом. Хоча жоден з них поки що не був переломним, це змусило мене думати інакше про те, як я розробляю програми та пишуть код. Є одна частина книги, з якою я не тільки не згоден, але й …

73 naming  interfaces  coding-standards 

Існуючі стандарти кодування у великому проекті C # містять правило про те, що всі назви типів мають повну кваліфікацію, забороняючи використовувати директиву "використання". Отже, а не знайоме: using System.Collections.Generic; .... other stuff .... List<string> myList = new List<string>(); (Мабуть, не дивно, що varтакож заборонено.) Я закінчую: System.Collections.Generic.List<string> myList = new …

71 c#  coding-standards 

Що зазвичай означають люди, коли ви бачите XXXв коментарі. Інколи я побачу такий коментар: # XXX - This widget really should frobulate the whatsit Звичайно, я можу сказати, що означає коментар, але що взагалі означає XXX? Це приказка "Це злом" чи, можливо, "Ми повинні переглянути це пізніше"? Або це говорить …

71 comments  coding-standards 

На новій роботі я отримував позначення в кодах оглядів такого коду: PowerManager::PowerManager(IMsgSender* msgSender) : msgSender_(msgSender) { } void PowerManager::SignalShutdown() { msgSender_->sendMsg("shutdown()"); } Мені сказали, що останній метод повинен читати: void PowerManager::SignalShutdown() { if (msgSender_) { msgSender_->sendMsg("shutdown()"); } } тобто я повинен поставити NULLохорону навколо msgSender_змінної, хоча вона є приватною особою …

65 c++  coding-standards 

Знак "плюс" +використовується для додавання і для з'єднання рядків, але його супутник: знак мінус -, як правило, не сприймається для обрізки рядків або іншого випадку, окрім віднімання. Що може бути причиною чи обмеженнями для цього? Розглянемо наступний приклад у JavaScript: var a = "abcdefg"; var b = "efg"; a-b == …

64 coding-standards  history  operators  overload 

Раніше були дуже вагомі причини, щоб імена інструкцій / реєстрів були короткими. Ці причини більше не застосовуються, але короткі криптовалютні імена все ще дуже поширені в програмуванні низького рівня. Чому це? Це просто тому, що старі звички важко порушити, чи є кращі причини? Наприклад: Atmel ATMEGA32U2 (2010?): TIFR1(Замість TimerCounter1InterruptFlag), ICR1H(замість …

64 naming  coding-standards  low-level 

Щойно я виявив, що я пишу наступний коментар у якомусь (архаїчному Visual Basic 6.0) коді, який я писав: If WindowState <> 1 Then 'The form's not minimized, so we can resize it safely '... End if Я не впевнений, чому я підсвідомо використовую "ми" у своїх коментарях. Я підозрюю, що …

63 comments  coding-standards 

У мене навряд чи рік досвіду в кодуванні. Після того, як я почав працювати, більшу частину часу я працював над чужим кодом, або додаючи нові функції над існуючими, або змінюючи існуючі функції. Хлопець, який написав фактичний код, більше не працює в моїй компанії. Мені важко зрозуміти його код і виконувати …

60 architecture  coding-style  coding-standards  coding  maintenance 

Останнім часом я багато працював у PHP та конкретно в рамках WordPress. Я помічаю багато коду у вигляді: if ( 1 == $options['postlink'] ) Де я б очікував побачити: if ( $options['postlink'] == 1 ) Чи є ця конвенція знайдена в певних мовах / рамках? Чи є причина, що колишній …

49 coding-style  coding-standards  conditions  defensive-programming 

Я читав ще одну тему, де хлопець розпитував про книги C ++ для початківців, а один із програмістів, відповідаючи, написав це: Деякі застереження: уникайте всіх книг, які представляють "привіт світ", в якому йдеться #include <iostream.h> Я відкрив свою книгу C ++ і досить впевнений, що вона включала заголовок iostream, як …

47 c++  coding-style  code-quality  coding-standards  headers 

Чи впливає довжина функції на продуктивність програміста? Якщо так, то яка хороша максимальна кількість рядків, щоб уникнути втрати продуктивності? Оскільки це дуже впевнена тема, будь ласка, підкріпіть заяву деякими даними.

44 programming-practices  coding-standards 

Я бачу подібні до цього питання щодо імен параметрів, які відповідають властивостям класу, але я не можу знайти нічого щодо використання імені параметра, яке є таким же, як назва типу параметра, за винятком корпусу в C #. Я не можу виявити порушення, але чи вважається це поганою практикою? Наприклад, у …

43 coding-standards  methods  parameters