Глава 5. Соглашения об именах и комментариях______________________105
удобочитаемым, надо добавить комментариев. Но прежде чем сделать это, давайте рассмотрим синтаксис комментариев в C++.
Типы комментариев в C++
В C++ допустимы две разновидности комментариев. Комментарии традиционного стиля, знакомые всем, кто имеет опыт программирования на С, начинаются знаком /* и заканчиваются знаком */. Вот небольшой пример:
/* это комментарий в одну строку */
/* этот комментарий занимает несколько строк */
Комментарии этого типа не могут быть вложенными. То есть конструкция
/* Это один комментарий, /* а здесь начинается- другой */ */
недопустима. Эта ситуация часто возникает, когда комментарии используются в процессе отладки. При этом вы можете написать что-нибудь вроде
while (*string &? /* *string \= ')' */) (
}
где условие *string != ')' временно закомментировано. Если впоследствии вы решите закомментировать цикл while целиком, то есть:
/* while (*string && /* *string != ')' */) (
) */
то при компиляции вы получите сообщение об ошибке:
Expression syntax
Однако компилятор Borland C++ 5 позволяет явно разрешить вложенные комментарии установкой соответствующего флага компиляции в IDE. Для этого необходимо проделать следующее:
1. В меню Options выберите Project. Появится окно диалога Project Options (рис. 5.1).
2. В списке разделов (Topics) двойным щелчком выберите Compiler.
3. Выберите пункт Source (исходный текст).
4. В опциях Source с правой стороны окна Project Options отметьте флажок Nested Comments (вложенные комментарии).
5. Для сохранения изменений нажмите ОК.