Технология программирования. Базовые конструкции C/C++. Липачев Е.К. - 7 стр.

     Правила комментирования – вопрос стиля программирования, которого
придерживается программист или           команда разработчиков. С
рекомендациями по правилам программирования и, в частности,
документированию кода, можно познакомиться в книге Голуб А. Правила
программирования на Си и Си++. Отличающиеся подходы к вопросу
документирования сформулированы в концепциях Literate Programming
(Грамотное программирование) и Extreme Programming (также XP и
Экстремальное программирование). Ссылки можно найти в сети Интернет.
     Отметим также, что комментирование активно используется при
отладке программ – часть операторов можно просто ―закомментировать‖ и,
тем самым, скрыть от компилятора, что, возможно, поможет локализовать
ошибку.

Директивы препроцессора
     Каждая программа на C/C++, как правило, начинается с директив
препроцессора – их можно узнать по символу ―#‖.
      Например, если в программе присутствуют операторы ввода и вывода,
то необходимо добавить инструкции
      #include 
      using namespace std;
или
      #include 
     Препроцессор обрабатывает код программы на первом шаге
компиляции. Его задача      – выполнение текстовых преобразований в
соответствии с директивами. Встретив директиву
#include "имя-файла" или #include <имя-файла>,
препроцессор заменит такую строку на код, записанный в указанном файле.
Разница в использовании кавычек (" ") и угловых скобок (< >) заключена в
пути поиска: файл, обрамленный угловыми скобками, ищется в системных
каталогах среды программирования, а файл в кавычках сначала ищется в
рабочем каталоге программы.
     Программы C/C++ обычно имеют несколько директив #include.
Файлы, добавляемые препроцессором, называют заголовочными, и они
традиционно имеют расширение .h.
      Директива макроподстановки:
       #define имя        текст
используется для замены: всюду в программе, где будет найдено имя, будет
произведена замена на текст.

                                    7