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

30
Использование условия finally для выполнения работы после возврата плохой стиль / опасно?

Как часть написания Iterator, я обнаружил, что пишу следующий фрагмент кода (обработка ошибок) public T next() { try { return next; } finally { next = fetcher.fetchNext(next); } } немного легче читать, чем public T next() { T tmp = next; next = fetcher.fetchNext(next); return tmp; } Я знаю, что это...

27
Как людям удается писать и поддерживать чрезвычайно сложный и трудный для чтения код? [закрыто]

Закрыто . Этот вопрос основан на мнении . В настоящее время не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы ответить на него фактами и цитатами, отредактировав этот пост . Закрыто 5 лет назад . Чтение исходного кода SQLite - миссия IMO, невозможная. Тем не менее, это...

26
Существует ли парадигма программирования, которая способствует тому, чтобы сделать зависимости чрезвычайно очевидными для других программистов?

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

25
Избегайте постфиксного приращения оператора

Я читал, что я должен избегать постфиксного оператора приращения из-за соображений производительности (в некоторых случаях). Но не влияет ли это на читаемость кода? По моему мнению: for(int i = 0; i < 42; i++); /* i will never equal 42! */ Выглядит лучше чем: for(int i = 0; i < 42; ++i); /* i...

25
Укажите необязательные имена параметров, даже если они не обязательны?

Рассмотрим следующий метод: public List<Guid> ReturnEmployeeIds(bool includeManagement = false) { } И следующий звонок: var ids = ReturnEmployeeIds(true); Для разработчика, плохо знакомого с системой, было бы довольно сложно догадаться, что именно true. Первое, что вы должны сделать - навести...

24
Фильтрация циклов foreach по условию where против продолжения guard

Я видел, как некоторые программисты используют это: foreach (var item in items) { if (item.Field != null) continue; if (item.State != ItemStates.Deleted) continue; // code } вместо того, где я обычно использовал бы: foreach (var item in items.Where(i => i.Field != null && i.State !=...

24
Что должны использовать плагины: хуки, события или что-то еще?

Рассмотрим приложение, которое позволяет плагинам реагировать на ход программы. Я знаю 2 способа добиться этого: хуки и события 1. Крючки Используйте вызовы для очистки функций внутри основного потока программы. Эти функции могут быть переопределены плагинами. Например, Drupal CMS реализует хуки,...

23
Допустимы ли длинные функции, если они имеют внутреннюю структуру?

При работе со сложными алгоритмами в языках с поддержкой вложенных функций (таких как Python и D) я часто пишу огромные функции (потому что алгоритм сложный), но смягчаю это, используя вложенные функции для структурирования сложного кода. Огромные (более 100 строк) функции по-прежнему считаются...

23
Как далеко должны 'var' и оператор объединения нулей '??' развлекаться без ущерба для читабельности?

Этот вопрос перенесен из Exchange Stack Exchange, так как на него можно ответить в Software Stack Exchange. Мигрировал 8 лет назад . Я знаю, что название вопроса очень субъективно, но я столкнулся с использованием ??оператора моими коллегами, где в то же время я был не очень доволен / не...

23
Является ли хорошей идеей предоставлять разные сигнатуры функций, которые делают одно и то же?

Вот класс C ++, который создается с тремя значениями. class Foo{ //Constructor Foo(std::string, int, char); private: std::string foo; char bar; int baz; }; Все типы параметров разные. Я мог бы перегрузить конструктор, чтобы порядок не имел значения. class Foo{ //Constructors Foo(std::string, char,...

22
Должен ли исходный код, выпущенный под лицензией GPL, быть читаемым человеком?

В ответ на другой вопрос , один из авторов предложил, что согласно GPL: ... вам нужно предоставить удобочитаемый [код], а не разделенную пробелами версию ... Мне кажется, что читаемость субъективна и вряд ли будет требоваться в GPL....

21
Вы предпочитаете краткость или удобочитаемость в вашем коде? [закрыто]

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

21
Почему JSX хорош, когда JSP скриптлеты плохи?

React.js предоставляет JSX в виде XHTML-подобного синтаксиса для построения дерева компонентов и элементов. JSX компилируется в Javascript, и вместо предоставления циклов или условных выражений в собственно JSX вы используете Javascript напрямую: <ul> {list.map((item) =>...

21
Как мне управлять очень большим набором правил и магических чисел в моей программе?

Я немного новичок в программировании (по профессии я инженер-механик), и во время простоя я разрабатываю небольшую программу, которая генерирует деталь (SolidWorks) на основе информации от разных людей со всего завода. Основываясь на нескольких входных данных (6, если быть точным), мне нужно...

20
Почему Bootstrap 3 меняет camelCase на тире - это более читабельно?

Мне интересно, в чем причина решения Bootstrap изменить все имена верблюдов на дефисные имена в версии 3.0. Я искал в Google и просмотрел несколько книг, но я могу найти мнения только так или иначе - нет достоверных данных. Существуют ли какие-либо исследования, которые предполагают, что имена...

20
Как удалить функцию или функцию при использовании TDD

В текстах о TDD я часто читал об «устранении дублирования» или «улучшении читаемости» на этапе рефакторинга. Но что заставляет меня удалить неиспользуемую функцию? Например, скажем, есть класс Cс методами a()и b(). Теперь я думаю, что было бы неплохо иметь метод, f()который используется C....

17
Описательное именование против 80 строк символов [закрыто]

В настоящее время этот вопрос не очень подходит для нашего формата вопросов и ответов. Мы ожидаем, что ответы будут подтверждены фактами, ссылками или опытом, но этот вопрос, скорее всего, вызовет дебаты, споры, опрос или расширенное обсуждение. Если вы считаете, что этот вопрос можно улучшить и,...

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

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

16
Что можно сделать, чтобы улучшить читаемость математически ориентированного кода на C #, Java и т.п.? [закрыто]

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

16
Один метод с множеством параметров против множества методов, которые должны вызываться по порядку

У меня есть некоторые необработанные данные, которые мне нужно сделать много (чтобы сдвинуть, повернуть, масштабировать по определенной оси, повернуть к конечной позиции), и я не уверен, что лучший способ сделать это для поддержания читабельности кода. С одной стороны, я могу сделать один метод со...