Вопросы с тегом «coding-standards»

Стандарты кодирования или соглашения о кодировании - это наборы правил или руководств, предназначенных для управления процессом производства кода в программном проекте. Обычно они основаны на лучших отраслевых практиках или общепринятых соглашениях. Они включают в себя соглашения об именах, стиль, запрещенные функции и многое другое.

17
Руководство по кодированию: методы не должны содержать более 7 операторов?
Я просматривал Рекомендации по кодированию AvSol для C #, и я согласен почти со всем, но мне действительно интересно посмотреть, что другие думают об одном конкретном правиле. AV1500 Методы не должны превышать 7 операторов. Метод, который требует более 7 операторов, выполняет слишком много или имеет слишком много обязанностей. Это также …

30
Худший стандарт кодирования, которому вы когда-либо должны были следовать? [закрыто]
Приходилось ли вам когда-либо работать над стандартами кодирования, которые: Сильно снизилась ваша производительность? Первоначально были включены по уважительным причинам, но были сохранены еще долго после того, как первоначальная проблема стала неактуальной Были ли в списке так долго, что было невозможно запомнить их всех? Считаете ли вы, что автор просто пытался …

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

7
Должны ли имена интерфейсов начинаться с префикса «I»?
Я читал « Чистый код » Роберта Мартина, чтобы, надеюсь, стать лучшим программистом. Хотя до сих пор ни один из них не был действительно новаторским, это заставило меня по-другому думать о том, как я проектирую приложения и пишу код. Есть одна часть книги, с которой я не только не согласен, …

9
Что ХХХ означает в комментарии? [закрыто]
Что люди обычно имеют в виду, когда вы видите XXXв комментарии. Иногда я увижу такой комментарий: # XXX - This widget really should frobulate the whatsit Конечно, я могу сказать, что означает комментарий, но что обычно означает XXX? Это говорит "Это взлом" или, может быть, "Мы должны вернуться к этому …

5
Почему бы вам не использовать директиву using в C #?
Существующие стандарты кодирования в большом проекте C # включают правило, согласно которому все имена типов должны быть полностью квалифицированными, что запрещает использование директивы using. Итак, а не знакомые using System.Collections.Generic; .... other stuff .... List<string> myList = new List<string>(); (Это, вероятно, не удивительно, что varтакже запрещено.) Я заканчиваю с: System.Collections.Generic.List<string> …

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

6
Почему знак минус «-», как правило, не перегружается так же, как знак плюс?
Знак плюс +используется для сложения и конкатенации строк, но его компаньон: знак минус -, как правило, не виден для обрезки строк или какого-либо другого случая, кроме вычитания. В чем может быть причина или ограничения для этого? Рассмотрим следующий пример в JavaScript: var a = "abcdefg"; var b = "efg"; a-b …

11
Почему загадочные короткие идентификаторы все еще так распространены в низкоуровневом программировании?
Раньше были очень веские причины для краткости названий инструкций / регистров. Эти причины больше не применяются, но короткие загадочные имена все еще очень распространены в низкоуровневом программировании. Почему это? Это просто потому, что старые привычки трудно сломать, или есть более веские причины? Например: Atmel ATMEGA32U2 (2010?): TIFR1(Вместо TimerCounter1InterruptFlag), ICR1H(вместо InputCapture1High), …

16
Являются ли комментарии от первого лица отвлекающими и непрофессиональными?
Я просто обнаружил, что пишу следующий комментарий в некотором (архаичном Visual Basic 6.0) коде, который я писал: If WindowState <> 1 Then 'The form's not minimized, so we can resize it safely '... End if Я не уверен, почему я подсознательно использую «мы» в моих комментариях. Я подозреваю, что это …

18
Работа над чужим кодом [закрыто]
У меня едва ли годовой опыт в программировании. После того, как я начал работать, большую часть времени я работал над чужим кодом, либо добавляя новые функции поверх существующих, либо модифицируя существующие. Парень, который написал настоящий код, больше не работает в моей компании. Мне трудно понять его код и выполнять свои …

4
if ('constant' == $ variable) против if ($ variable == 'constant')
В последнее время я много работал над PHP и, в частности, в рамках WordPress. Я замечаю много кода в виде: if ( 1 == $options['postlink'] ) Где бы я ожидал увидеть: if ( $options['postlink'] == 1 ) Это соглашение встречается в определенных языках / структурах? Есть ли какая-либо причина, по …

4
Почему #include <iostream.h> плохо?
Я читал другую ветку, где парень спрашивал о книгах по С ++ для начинающих, и один из отвечавших программистов написал это: Некоторые предупреждения: избегайте всех книг, которые представляют «привет мир» с #include &lt;iostream.h&gt; Я открыл свою книгу по C ++ и, конечно же, включил заголовок iostream, как в примере выше. …

18
Что доказано как хорошая максимальная длина функции? [закрыто]
Влияет ли длина функции на производительность программиста? Если да, то какое максимальное количество строк нужно избежать, чтобы избежать потери производительности? Так как это очень мнительная тема, пожалуйста, подкрепите заявку некоторыми данными.

7
Является ли использование имен параметров, которые отличаются от имен типов только регистром, плохой практикой в ​​C #?
Я вижу подобные вопросы в отношении имен параметров, которые соответствуют свойствам класса, но я не могу найти ничего относительно использования имени параметра, совпадающего с именем типа параметра, за исключением случая в C #. Кажется, это не нарушение, которое я могу найти, но считается ли это плохой практикой? Например, у меня …

Используя наш сайт, вы подтверждаете, что прочитали и поняли нашу Политику в отношении файлов cookie и Политику конфиденциальности.
Licensed under cc by-sa 3.0 with attribution required.