Соглашения по стилю написания кода для WebKit

webkit.org, “WebKit Coding Style Guidelines”, public translation into Russian from English More about this translation.

Translate into another language.

Отступы

Используйте пробелы вместо табуляций. Символы табуляции следует использовать только в тех файлах, в которых они имеют особое семантическое значение, например, в make-файлах.

Размер отступа должен быть равен четырем пробелам.

Правильно:

int main()

{

return 0;

}

Неправильно:

int main()

{

return 0;

}

В заголовочном файле код внутри пространства имен не должен содержать лишних отступов.

Правильно:

// Document.h

namespace WebCore {

class Document {

Document();

...

};

} // namespace WebCore

Неправильно:

// Document.h

namespace WebCore {

class Document {

Document();

...

};

} // namespace WebCore

В файле реализации (файлы с расширением .cpp, .c или .mm) код внутри пространства имен также не должен содержать лишних отступов.

Правильно:

// Document.cpp

namespace WebCore {

Document::Document()

{

...

}

} // namespace WebCore

Неправильно:

// Document.cpp

namespace WebCore {

Document::Document()

{

...

}

} // namespace WebCore

Каждый случай (case) в операторе switch должен иметь тот же отступ, что и сам оператор. Содержимое case-блока должно содержать один дополнительный отступ.

Правильно:

switch (condition) {

case fooCondition:

case barCondition:

i++;

break;

default:

i--;

}

Неправильно:

switch (condition) {

case fooCondition:

case barCondition:

i++;

break;

default:

i--;

}

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

Правильно:

return attr->name() == srcAttr

|| attr->name() == lowsrcAttr

|| (attr->name() == usemapAttr && attr->value().domString()[0] != '#');

Неправильно:

return attr->name() == srcAttr ||

attr->name() == lowsrcAttr ||

(attr->name() == usemapAttr && attr->value().domString()[0] != '#');

Использование пробелов

Не следует отделять пробелами унарный оператор от его аргумента.

Правильно:

i++;

Неправильно:

i ++;

Между бинарными и тернарными операторами пробелы следует ставить.

Правильно:

y = m * x + b;

f(a, b);

c = a | b;

return condition ? 1 : 0;

Неправильно:

y=m*x+b;

f(a,b);

c = a|b;

return condition ? 1:0;

Не следует ставить пробел перед запятой и точкой с запятой.

Правильно:

for (int i = 0; i < 10; i++)

doSomething();

f(a, b);

Неправильно:

for (int i = 0 ; i < 10 ; i++)

doSomething();

Pages: ← previous Ctrl next
1 2 3 4

© webkit.org

Original (English): WebKit Coding Style Guidelines

Translation: © Alex .

translated.by crowd

Like this translation? Share it or bookmark!