Вопросы с тегом «readability»

Читаемость измеряет, насколько легко код читать и понимать.

336
Как бы вы узнали, если вы написали читаемый и легко обслуживаемый код?

Как узнать, что созданный код легко читается, понятен и поддерживается? Конечно, с точки зрения автора, код удобен для чтения и сопровождения, потому что автор написал и отредактировал его, для начала. Однако должен существовать объективный и поддающийся количественному измерению стандарт, по...

192
Являются ли `break` и` continue` методами программирования?

Мой босс продолжает упоминать беспечно , что плохие программисты используют breakи continueв петлях. Я использую их все время, потому что они имеют смысл; позвольте мне показать вам вдохновение: function verify(object) { if (object->value < 0) return false; if (object->value >...

160
Есть ли конкретная причина плохой читаемости синтаксиса регулярных выражений?

Все программисты, похоже, согласны с тем, что читаемость кода гораздо важнее, чем однострочные с коротким синтаксисом, которые работают, но требуют, чтобы старший разработчик интерпретировал их с какой-то степенью точности - но, похоже, именно так были разработаны регулярные выражения. Была ли...

139
Являются ли закрытые методы с одной ссылкой плохим стилем?

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

67
Чистый читаемый код против быстрого трудно читаемого кода. Когда пересекать черту?

Когда я пишу код, я всегда стараюсь сделать мой код максимально чистым и читабельным. Время от времени наступает момент, когда вам нужно пересечь черту и перейти от красивого чистого кода к более уродливому коду, чтобы сделать его быстрее. Когда это нормально, чтобы пересечь эту...

64
Длинные методы всегда плохи? [закрыто]

Поэтому, оглядываясь назад, я заметил несколько комментариев о том, что длинные методы являются плохой практикой. Я не уверен, что всегда согласен с тем, что длинные методы плохие (и хотел бы узнать мнение других). Например, у меня есть несколько представлений Django, которые выполняют небольшую...

63
Является ли большое логическое выражение более читабельным, чем то же выражение, разбитое на методы предикатов? [закрыто]

Что легче понять: большой логический оператор (довольно сложный) или тот же оператор, разбитый на методы предикатов (много дополнительного кода для чтения)? Вариант 1, большое логическое выражение: private static bool ContextMatchesProp(CurrentSearchContext context, TValToMatch propVal) { return...

59
Когда и для каких целей в C следует использовать ключевое слово const для переменных?

При рассмотрении моего кода здесьconst возникла проблема использования ключевого слова. Я понимаю, что он используется для реализации поведения переменных только для чтения. Я не понимаю, какие существуют ситуации, когда это может быть полезно. Должно ли оно использоваться для ясности в прототипах...

57
Удобочитаемость в сравнении с ремонтопригодностью, особый случай написания вызовов вложенных функций

Мой стиль кодирования для вызовов вложенных функций следующий: 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); Недавно я перешел в отдел, где очень популярен следующий стиль кодирования: var a =...

52
Каково доминирующее соглашение по именованию переменных в PHP: верблюд или подчеркивание? [закрыто]

Похоже, консенсус заключается в том, что нужно следовать соглашению платформы, для которой они разрабатывают. Видеть: Подчеркивание или верблюд? Соглашения об именах: camelCase или underscore_case? Тем не менее, PHP, кажется, строго не следует никаким внутренним соглашениям (никаких сюрпризов) даже...

45
Преднамеренные опечатки, чтобы избежать зарезервированных слов

Я часто вижу код, который включает преднамеренные опечатки общих слов, которые, к лучшему или худшему, стали зарезервированными словами: klassили clazzдля класса :Class clazz = ThisClass.class kountдля подсчета в SQL:count(*) AS kount Лично я считаю, что это снижает читабельность. В моей...

44
Плохо ли называть неиспользуемую переменную одним подчеркиванием?

Часто, когда синтаксис языка требует, чтобы я назвал переменную, которая никогда не используется, я назову ее _. На мой взгляд, это уменьшает беспорядок и позволяет мне сосредоточиться на значимых переменных в коде. Я нахожу это ненавязчивым, так что он производит эффект «с глаз долой, с ума»....

40
Является ли нежелательным создание функции, которая по существу переименовывает встроенную функцию?

Я запутался в функциях min и max в определенных контекстах. В одном контексте, когда вы используете функции для получения большего или меньшего из двух значений, это не проблема. Например, //how many autographed CD's can I give out? int howManyAutographs(int CDs, int Cases, int Pens) { //if no...

37
Стоит ли жертвовать читабельностью кода тем, насколько он эффективен? [закрыто]

Стоит ли жертвовать читабельностью кода тем, насколько он эффективен? например, 3 строки кода в 1 строку. Я прочитал в Code Craft Питом Гудлиффом, что читабельность - это ключ. Твои...

37
При использовании метода цепочки я повторно использую объект или создаю его?

При использовании метода цепочки, как: var car = new Car().OfBrand(Brand.Ford).OfModel(12345).PaintedIn(Color.Silver).Create(); может быть два подхода: Повторно используйте тот же объект, например так: public Car PaintedIn(Color color) { this.Color = color; return this; } Создавайте новый объект...

34
Почему многие разработчики считают, что производительность, удобочитаемость и удобство обслуживания не могут сосуществовать?

Отвечая на этот вопрос , я начал задаваться вопросом, почему многие разработчики считают, что хороший дизайн не должен учитывать производительность, поскольку это может повлиять на удобочитаемость и / или удобство обслуживания. Я считаю, что хороший дизайн также учитывает производительность во...

33
Почему вложенные циклы считаются плохой практикой?

Мой лектор упомянул сегодня, что в Java можно «пометить» циклы, чтобы вы могли обращаться к ним при работе с вложенными циклами. Поэтому я посмотрел эту функцию, так как не знал об этом, и во многих местах, где эта функция была объяснена, за ней последовало предупреждение, препятствующее вложенным...

32
Всегда ли простота улучшает читабельность?

Недавно я разрабатывал набор стандартов кодирования для нашей компании. (Мы новая команда, разрабатывающая новый язык для компании.) В своем первом проекте я поставил цель наших стандартов кодирования: улучшить удобочитаемость, ремонтопригодность, надежность и производительность. (Я проигнорировал...

32
В то время как (правда) и разрыв цикла - анти-шаблон?

Рассмотрим следующий код: public void doSomething(int input) { while(true) { TransformInSomeWay(input); if(ProcessingComplete(input)) break; DoSomethingElseTo(input); } } Предположим, что этот процесс включает в себя конечное, но зависящее от ввода число шагов; Цикл предназначен для...

31
Использование магических строк / чисел [закрыто]

Закрыто . Этот вопрос должен быть более сфокусированным . В настоящее время не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы он был сосредоточен только на одной проблеме, отредактировав этот пост . Закрыто 5 лет назад . Это довольно спорная тема, и я думаю, что мнений...