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

15
Хорошее использование try catch-блоков?

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

15
Изучите, насколько хорошо программист может понимать код на незнакомых языках? [закрыто]

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

15
C # становится все труднее читать?

По мере развития C # было добавлено много языковых возможностей. Это дошло до того, что это становится нечитаемым для меня. В качестве примера рассмотрим следующий фрагмент кода из кода Caliburn.Micro здесь : container = CompositionHost.Initialize( new AggregateCatalog( AssemblySource.Instance....

15
Ноль как константа?

Я недавно сталкивался с этой идиомой программирования: const float Zero = 0.0; который затем используется в сравнениях: if (x > Zero) {..} Может ли кто-нибудь объяснить, действительно ли это более эффективно, доступно для чтения или сопровождения, чем: if (x > 0.0) {..} ПРИМЕЧАНИЕ: я могу...

14
Существуют ли какие-либо реальные недостатки цепочки самореферентных методов?

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

14
Должны ли мы переименовать перегруженные методы?

Предположим интерфейс, содержащий эти методы: Car find(long id); List<Car> find(String model); Лучше переименовать их так? Car findById(long id); List findByModel(String model); Действительно, любому разработчику, использующему этот API, не нужно смотреть на интерфейс, чтобы узнать возможные...

14
Почему многие языки не поддерживают именованные параметры? [закрыто]

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

13
Как мне написать тест для чистого метода, который ничего не возвращает?

У меня есть куча классов, которые занимаются проверкой значений. Например, RangeValidatorкласс проверяет, находится ли значение в указанном диапазоне. Каждый класс валидатора содержит два метода:, is_valid(value)который возвращает Trueили Falseзависит от значения, и ensure_valid(value)который...

13
Какой способ прервать цикл чтения является предпочтительным?

Когда вам нужно перебрать читателя, где количество элементов для чтения неизвестно, и единственный способ сделать это - продолжить чтение до конца. Это часто место, где вам нужен бесконечный цикл. Существует Всегда trueчто указывает на то , должно быть , breakили returnзаявление где - то внутри...

13
Сигилы облегчают чтение исходного кода?

В большинстве языков программирования переменные не имеют идентифицирующих символов, как в PHP. В PHP вы должны префикс переменной с $символом. Пример; var $foo = "something"; echo $foo; Я разрабатываю новый язык сценариев для бизнес-приложений, и у моих целевых пользователей нет опыта...

13
Как написать читаемый код Clojure?

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

13
Подчеркните отрицание

Я просто писал оператор if с довольно длинными именами свойств и столкнулся с этой проблемой. Допустим, у нас есть выражение if, подобное этому: if(_someViewModelNameThatIsLong.AnotherPropertyINeedToCheck == someValue && !_someViewModelNameThatIsLong.ThisIsABooleanPropertyThatIsImportant) {...

13
Удобочитаемость функционального программирования [закрыто]

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

12
Не правильно ли использовать флаги для «группировки» перечислений?

Насколько я понимаю, [Flag]перечисления обычно используются для вещей, которые можно комбинировать, когда отдельные значения не являются взаимоисключающими . Например: [Flags] public enum SomeAttributes { Foo = 1 << 0, Bar = 1 << 1, Baz = 1 << 2, } Если какое - либо...

11
Повторение кода против многоответственного метода

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

11
«Статичный» как смысловой ключ к безгражданству?

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

11
Что более приемлемо - булево присваивание через if / else или логическое выражение?

Что будет считаться более ремонтопригодным? if (a == b) c = true; else c = false; или же c = (a == b); Я пытался посмотреть в Code Complete, но не могу найти ответ. Я думаю, что первое является более читабельным (вы можете буквально прочитать его вслух), что, как мне кажется, делает его более...

11
Нужно сделать мой код более читабельным для других программистов в моей команде

Я работаю над проектом в Delphi, и я создаю установщик для приложения, состоит из трех основных частей. Установка / удаление PostgreSQL myapplication (настройка myapplication создается с использованием nsi) установка / удаление. Создание таблиц в Postgres через скрипт (пакетные файлы). Все работает...

11
Должны ли «математические» функции следовать математическим обозначениям?

Я полагаю, что этот вопрос будет немедленно помечен как субъективный, но какой, по вашему мнению, лучше: double volume(double pressure, double n_moles, double temperature) { return n_moles * BOLTZMANN_CONSTANT * temperature / pressure; } или же double volume(double P, double n, double T) { return...

11
Поддерживаемость булевой логики - есть ли необходимость в вложении операторов?

Что из этого лучше для ремонтопригодности? if (byteArrayVariable != null) if (byteArrayVariable .Length != 0) //Do something with byteArrayVariable ИЛИ ЖЕ if ((byteArrayVariable != null) && (byteArrayVariable.Length != 0)) //Do something with byteArrayVariable Я предпочитаю читать и писать...