В языке С++ существуют два вида комментариев: однострочные и парные. Однострочный комментарий начинается символом двойной наклонной черты (>//) и завершается в конце строки. Все, что находится справа от этого символа в текущей строке, игнорируется компилятором.

Второй тип комментария, заключенного в пару символов (>/* и >*/), унаследован от языка С. Такие комментарии начинаются символом >/* и завершаются символом >*/. Эти комментарии способны содержать все что угодно, включая новые строки, за исключением символа >*/. Все, что находится между символами >/* и >*/, компилятор считает комментарием.

В парном комментарии могут располагаться любые символы, включая символ табуляции, пробел и символ новой строки. Парный комментарий может занимать несколько строк кода, но это не обязательно. Когда парный комментарий занимает несколько строк кода, имеет смысл указать визуально, что эти строки принадлежат многострочному комментарию. Применяемый в этой книге стиль предполагает использование для обозначения внутренних строк многострочного комментария символы звездочки. Таким образом, символ звездочки в начале строки свидетельствует о ее принадлежности к многострочному комментарию (но это необязательно).

В программах обычно используются обе формы комментариев. Парные комментарии, как правило, используют для многострочных объяснений[2], а двойную наклонную черту — для замечаний в той же строке, что и код.

>#include

>/*

> * Пример функции main():

> * Читает два числа и отображает их сумму

>*/

>int main()

>{

> // Предлагает пользователю ввести два числа

> std::cout << "Enter two numbers:" << std::endl;

> int v1 = 0, v2 = 0;   // переменные для хранения ввода

> std::cin >> v1 >> v2; // чтение ввода

> std::cout << "The sum of " << v1 << " and " << v2

>           << " is " << v1 + v2 << std::endl;

> return 0;

>}

Комментарий, который начинается символом >/*, всегда завершается следующим символом >*/. Поэтому один парный комментарий не может находиться в другом. Сообщение о подобной ошибке, выданное компилятором, как правило, вызывает удивление. Попробуйте, например, откомпилировать следующую программу:

>/*

>* парный комментарий /* */ не допускает вложения

>* под "не допускает вложения" следует понимать, что остальная часть

>* текста будет рассматриваться как программный код

>*/

>int main()

>{

> return 0;

>}

Упражнение 1.7. Попробуйте откомпилировать программу, содержащую недопустимо вложенный комментарий.

Упражнение 1.8. Укажите, какой из следующих операторов вывода (если он есть) является допустимым:

>std::cout << "/*";

>std::cout << "*/";

>std::cout << /* "*/" */;

>std::cout << /* "*/" /* "/*" */;

Откомпилируйте программу с этими тремя операторами и проверьте правильность своего ответа. Исправьте ошибки, сообщения о которых были получены.