Программирование на языке C. Комментарии

Комментарии - это данные, предназначенные только для вас. Компилятор их полностью игнорирует. Цель комментариев - пояснить содержание программы.

Заключайте комментарии в двухсимвольные ограничители /* и */. Вот пример:

/* Моя первая программа */

Компилятор полностью игнорирует все символы в комментариях, включая ограничители. Комментарии могут стоять в конце оператора:

printf("Print this text"); /* отображение текста на экране */

Однако их нельзя ставить внутри текста, заключенного в кавычки, или внутри идентификаторов:

printf("Not /* коомментарий */"); /* ??? */

int bad/* комментарий */Identifier; / *??? */

Мы будем использовать комментарии /* ??? */ для обозначения неправильных конструкций или сомнительных действий. Приведенные выше две строки никуда не годятся.

Вы можете писать комментарии, которые занимают одну или

несколько строк, используя одну пару ограничителей. Следующие три строки текста представляют собой один комментарий:

/* Моя вторая с-программа

Написана 11.09.2012

Автор: имя */

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

/*

** Программа: Моя третья С-программа

** Дата: 12.09.2012

** Автор: имя */

Дополнительные звездочки здесь только для красоты оформления.

Отладка с комментариями

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

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

main ()

{

printf("Welcome to С Programming!n");

/*

return 0;

*/

}

Компилятор теперь проигнорирует этот оператор, который можно легко восстановить, убрав ограничители.

Замечание. Пользуйтесь комментариями умеренно. Хорошие программы удобочитаемы сами по себе, и вам следует привыкать к чтению программного кода, а не только комментариев. Используйте комментарии, чтобы прояснить значение ключевых мест в ваших программах или для

сообщения информации (как правило, в начале файла) о назначении программы, параметрах, авторе и т.п.

 

< Предыдущая		Следующая >