FLEXible блог

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

Начнем с форматирования исходников:

Очень часто, и в книгах, и в Интернет, и (возможно) от начальства, можно слышать про необходимость комментариев. Давайте посмотрим, насколько написание комментариев является необходимым.

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

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

Я уже вскользь писал на эту тему ранее, в статье "Как не надо писать код". Но в том случае упоминалось лишь о том, что мне не нравится, а не о том, как все должно быть на самом деле.

Я не собираюсь писать, скажем, про паттерны, про них и без меня написано многое. Мне приходится (и я этому рад) работать с самым разным кодом - отличным и ужасным, разных авторов, на разных языках программирования. В связи с этим я вкратце изложу, какой стиль программирования я считаю правильным и почему. Не настаивая на том, что моя точка зрения - мудрая, правильная и единственно верная (© Ильф и Петров).

Небольшой цикл статей "Хороший, качественный код" - скорее повод задуматься, чем руководство к действию.