Стилистика оформления кода
Posted: Sat Apr 18, 2009 7:25 pm
Данная тема описывает текущую принятую стилистику оформления кода. Стилистика эта не лучше и не хуже любых других, она просто есть, и крайне желательно при создании изменений её придерживаться, дабы проект выглядел единообразно и целостно. Это может оказаться неудобно, но тут ничего не поделаешь.
Текущая принятая стилистика написания кода в проекте следующая:
Отступы -- два пробела.
Открывающая фигурная скобка -- на следующей строке, прямо под конструкцией:
Пробелы внутри скобок и между разнообразными зведочками и операторами присутствуют:
Наименование классов, структур, enum и namespace -- CamelCase, описывающий класс как существительное, с возможным прилагательным.
Наименование объектов, в том числе и членов классов -- camelCase с маленькой буквы, описывающий объект как существительное, с возможным прилагательным. Добавлять префиксы типа m_ и прочие не надо.
Наименование функций, в том числе и членов классов -- camelCase с маленькой буквы, описывающий функцию как глагол, действие, или вопрос:
Именование файлов -- .cc для C++-файлов, .hh для их хедеров.
Если что-то здесь не описано, посмотрите на существующий код, и просто сделайте так же, как и там.
Текущая принятая стилистика написания кода в проекте следующая:
Отступы -- два пробела.
- Code: Select all
if ( foo )
bar();
Открывающая фигурная скобка -- на следующей строке, прямо под конструкцией:
- Code: Select all
if ( foo )
{
bar();
}
Пробелы внутри скобок и между разнообразными зведочками и операторами присутствуют:
- Code: Select all
char const * foo = strstr( somePtr + 5, "match" );
Наименование классов, структур, enum и namespace -- CamelCase, описывающий класс как существительное, с возможным прилагательным.
- Code: Select all
class Window;
struct Dictionary;
namespace Options;
enum UserChoice;
Наименование объектов, в том числе и членов классов -- camelCase с маленькой буквы, описывающий объект как существительное, с возможным прилагательным. Добавлять префиксы типа m_ и прочие не надо.
- Code: Select all
int someVar;
struct GreatStructure
{
string niceString;
};
Наименование функций, в том числе и членов классов -- camelCase с маленькой буквы, описывающий функцию как глагол, действие, или вопрос:
- Code: Select all
void doSomething();
struct Apartment
{
void turnLightOn();
bool isLightOn() const;
};
Именование файлов -- .cc для C++-файлов, .hh для их хедеров.
- Code: Select all
file.hh
file.cc
Если что-то здесь не описано, посмотрите на существующий код, и просто сделайте так же, как и там.