Проверка стиля в ejudge: частые ошибки

Каждая посылка в ejudge проходит проверку стиля утилитой cpplint.

Что именно проверяется

Команда, которую запускает ejudge:

cpplint --filter="-,+whitespace,+readability,-readability/casting,-whitespace/ending_newline,-whitespace/tab,+build/include_what_you_use" --linelength=140 solution.cpp

Правила основаны на Google C++ Style Guide. using namespace std;, long long и отсутствие копирайта не проверяются.

Каждая ошибка в выводе выглядит так:

solution.cpp:8:  Missing space before ( in while(  [whitespace/parens] [5]

Это файл, номер строки, описание, категория в квадратных скобках (по ней ищите в таблице выше) и уверенность от 1 до 5.

Частые ошибки

int main(){        // ❌
int main() {       // ✅

• #include <bits/stdc++.h> не является стандартным заголовком: он есть только в GCC, а в Visual Studio код не скомпилируется. cpplint о нём не знает и требует <iostream> и прочие. Подключайте заголовки явно.
• Используете std::string? Добавьте #include <string>. То, что код компилируется только с <iostream>, случайность конкретного компилятора.
• freopen/fclose требуют #include <cstdio>.

#include <iostream>
#include <string>
#include <vector>

Обычно это «пустые» строки, в которых остался отступ. Их не видно глазами, поэтому включите в редакторе «Trim trailing whitespace on save» (удалять пробелы в конце строк при сохранении).

int a,b;                              // ❌
int a, b;                             // ✅
freopen("in.txt", "r", stdin);        // ✅

int main()
{                  // ❌
int main() {       // ✅ открывающая скобка в конце предыдущей строки

for(int i = 0;i < n;i++){          // ❌ сразу три ошибки
for (int i = 0; i < n; i++) {      // ✅
while (cin >> x) {                 // ✅

cin>>a>>b;  cout<<x;  i<n;  a=b;               // ❌
cin >> a >> b;  cout << x;  i < n;  a = b;     // ✅

int main() {
                   // ❌ лишняя пустая строка после {
    cout << 1;
                   // ❌ лишняя пустая строка перед }
}

signed main () {     // ❌ пробел между именем функции и (
f( x );  if (a ) {   // ❌ пробелы внутри скобок
signed main() {      // ✅
f(x);  if (a) {      // ✅

int a, b;cin >> a >> b;   // ❌
return 0 ;                // ❌
int a, b;                 // ✅ одна команда на строку
cin >> a >> b;
return 0;

Реже встречаются for (int x:v) вместо for (int x : v), i ++ вместо i++ и неправильный отступ у public:/private: (нужен ровно 1 пробел от начала класса).

Как запустить cpplint у себя

1. Установите Python 3 (python.org; на Windows отметьте галочку «Add Python to PATH»).
2. Установите cpplint:

   python -m pip install cpplint

   На Windows можно py -m pip install cpplint.
3. Проверьте файл той же командой, что и ejudge:

   python -m cpplint --filter="-,+whitespace,+readability,-readability/casting,-whitespace/ending_newline,-whitespace/tab,+build/include_what_you_use" --linelength=140 solution.cpp

   Все .cpp в папке и подпапках проверяются так: замените solution.cpp на --recursive .

Если вывод состоит только из Done processing solution.cpp, всё чисто и ejudge пропустит посылку. Иначе в конце будет Total errors found: N.

Запуск именно через python -m cpplint работает, даже когда команда cpplint «не найдена». Предупреждение DeprecationWarning: codecs.open() на новых версиях Python не влияет на результат, его можно игнорировать.

Автоисправление: clang-format

clang-format — это программа, которая автоматически расставляет в коде пробелы, отступы, переносы строк и фигурные скобки по заданным правилам. Сам код (что он делает) она не меняет, только его оформление. Настроенный clang-format исправляет все ошибки из списка выше, кроме №2 (про #include): заголовки нужно подключить самостоятельно.

Установите его командой python -m pip install clang-format. В CLion и Visual Studio он уже встроен (см. Настройка в IDE).

Как настроить clang-format

Правила форматирования clang-format берёт из файла настроек .clang-format. Без этого файла он отформатирует код не так, как требует проверка в ejudge.

Требования к файлу:

• имя ровно .clang-format: с точкой в начале и без расширения (не .clang-format.txt и не clang-format);
• это обычный текстовый файл; каждая настройка на своей строке в виде Название: значение, после двоеточия пробел;
• регистр букв в названиях важен.

Содержимое файла целиком (скопируйте как есть):

BasedOnStyle: Google
ColumnLimit: 140
IndentWidth: 4
AccessModifierOffset: -3

Что означает каждая строка:

Где должен лежать файл

clang-format ищет .clang-format в папке с вашим .cpp, затем в папке выше и так далее. Поэтому достаточно положить один файл в общую папку с задачами:

contest/
├── .clang-format
├── A/
│   └── solution.cpp
└── B/
    └── solution.cpp

Как отформатировать и проверить

Отформатировать файл (изменения сохраняются прямо в нём):

clang-format -i solution.cpp

Проверить, что clang-format нашёл ваш .clang-format:

clang-format --dump-config solution.cpp

Среди длинного списка настроек найдите строку ColumnLimit: там должно быть 140 (пробелов после двоеточия может быть несколько). Если там 80, файл не найден: проверьте его имя (нет ли .txt на конце) и папку, в которой он лежит.

Документация: ClangFormat, все опции.

Настройка в IDE

Во всех примерах ниже <ФИЛЬТР> означает строку:

"-,+whitespace,+readability,-readability/casting,-whitespace/ending_newline,-whitespace/tab,+build/include_what_you_use"

CLion

• Форматирование. Положите .clang-format в корень проекта, и CLion подхватит его сам (проверить можно в Settings → Editor → Code Style → «Enable ClangFormat»). Форматирование запускается сочетанием Ctrl+Alt+L (macOS: ⌥⌘L).
• cpplint. Settings → Tools → External Tools → +:
  • Program: python (macOS/Linux: python3)
  • Arguments: -m cpplint --output=eclipse --filter=<ФИЛЬТР> --linelength=140 $FilePath$
  • Working directory: $FileDir$
  • в Advanced Options → Output Filters добавьте $FILE_PATH$:$LINE$:.*, тогда строки с ошибками станут кликабельными.
  Запуск: Tools → External Tools → cpplint (или правый клик по файлу).

Visual Studio

• Форматирование. Tools → Options → Text Editor → C/C++ → Code Style → Formatting → включите «Enable ClangFormat support». Положите .clang-format в папку проекта. Форматирование: Ctrl+K, Ctrl+D.
• cpplint. Tools → External Tools… → Add:
  • Title: cpplint
  • Command: полный путь к python.exe (или C:\Windows\py.exe)
  • Arguments: -m cpplint --output=vs7 --filter=<ФИЛЬТР> --linelength=140 "$(ItemPath)"
  • Initial directory: $(ItemDir)
  • включите «Use Output window»
  Ошибки появятся в окне Output. Двойной клик по строке переносит к месту ошибки.

Code::Blocks

• cpplint. Tools → Configure tools… → Add:
  • Name: cpplint
  • Executable: python (на Windows лучше полный путь к python.exe)
  • Parameters: -m cpplint --filter=<ФИЛЬТР> --linelength=140 "${ACTIVE_EDITOR_FILENAME}"
  • Launching options: «Launch tool hidden with standard output redirected», тогда вывод будет во вкладке логов.
• Форматирование. Встроенный форматтер (Plugins → Source code formatter (AStyle), стиль Google) не совпадает с правилами cpplint один в один. Надёжнее добавить ещё один инструмент так же, как выше: Executable clang-format, Parameters -i "${ACTIVE_EDITOR_FILENAME}". После запуска Code::Blocks предложит перезагрузить файл.

VS Code

Установите расширения C/C++ и cpplint. Форматирование Shift+Alt+F использует ваш .clang-format.

Рецепт перед отправкой

1. Отформатируйте файл (clang-format из консоли или сочетание клавиш в IDE).
2. Проверьте #include: каждый используемый заголовок подключён явно, без bits/stdc++.h.
3. Прогоните cpplint командой выше. Если вывод пустой (кроме Done processing), отправляйте.