Стилевой кодовый минимум

Материал из YourcmcWiki
Перейти к: навигация, поиск

Чтобы был качественный код, лучше следовать какому-то Style Guide, например гугловскому: http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml

Но «чтобы не было говна», какому стилю следовать — не так важно, главное следовать хоть какому-то.

Как минимум:

Отступы

Я рекомендую использовать для отступов только пробелы и размер табуляции в 4 символа. НО не так важно, табы или пробелы и какой размер табуляции!

Важно, чтобы размер отступа был ОДИНАКОВЫЙ по всей программе и чтобы не было СМЕСИ табов с пробелами!

В Интернетах есть куча срачей на тему «табы vs пробелы», но когда в тред приходит человек, который говорит, что ему всё равно, хоть смесь — его точно бьют и те, и другие :)

Соответственно, если используем пробелы, в опциях редактора отключаем табы!

Если в редакторе есть ещё и режим «эмуляции половины таба», обязательно отключите и его, ибо он генерирует смесь табов и пробелов! Пример такого редактора — встроенный в Midnight Commander.

Если же используем табы, то делаем все отступы исключительно табами!

Блоки и функции

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

Очень желательно: Можно, но не нужно — визуально тело сливается с условием: НИ В КОЕМ СЛУЧАЕ:

<<<<<<< старый текст:

if (...)
{
    код...
}

=

if (...)
{
    код...
}

>>>>>>> (чужая версия)

<<<<<<< старый текст:

if (...) {
    код...
}

=

if (...) {
    код...
}

>>>>>>> (чужая версия) Хотя, например, perlstyle предлагает именно этот способ форматирования блоков, лично я не использую его и в Perl-коде, ибо неудобно.

<<<<<<< старый текст:

if (...)
    {
    код...
    }

=

if (...)
    {
    код...
    }

>>>>>>> (чужая версия) или <<<<<<< старый текст:

if (...)
  {
    код...
  }

=

if (...)
  {
    код...
  }

>>>>>>> (чужая версия)