1.2 Комментарии

На верх  Назад  Вперёд

Комментарии это фрагменты исходного кода, которые полностью игнорируются компилятором. Они существуют только для выгоды программиста, так он может объяснить определенные фрагменты кода. Для компилятора, это то же самое что их и не было.

Следующая часть кода демонстрирует комментарий:

(*  Моя красивая функция возвращает интересный результат  *)

Function Beautiful : Integer;

(* и *) использовались как разделители комментариев с самых первых дней языка Pascal. Они были заменены с помощью { и }, как в следующем примере:

{ Моя красивая функция возвращает интересный результат  }

Function Beautiful : Integer;

Комментарий может занимать несколько строк:

{

    Моя прекрасная функция возвращает интересный результат,

но только если аргумент A меньше, чем B.

}

Function Beautiful (A,B : Integer): Integer;

Однострочные комментарии могут быть указаны также с помощью разделителя //:

// Моя прекрасная функция возвращает интересный результат
Function Beautiful : Integer;

Комментарий продолжается от символа // до конца строки. Этот вид комментария был представлен Borland в компиляторе Pascal Delphi.

Free Pascal поддерживает использование вложенных комментариев. Следующие конструкции - допустимые комментарии:

(*  Это комментарий в старом стиле*)

{    Это комментарий Turbo Pascal }

//  Это комментарий Delphi. Все до конца строки игнорируется.

Ниже приводятся допустимые способы вложения комментариев:

{  Комментарий  1  (*  Комментарий  2  *)  }

(*  Комментарий  1  {   Комментарий  2  }  *)

{   Комментарий  1  //  Комментарий  2  }

(*  Комментарий  1  //  Комментарий  2  *)

//  Комментарий  1  (*  Комментарий  2  *)

//  Комментарий  1  {   Комментарий  2  }

Последние два комментария должны быть на одной строке. Следующие два дадут ошибки:

//  Допустимый комментарий { Больше не действительный комментарий!!

  }

и

//  Допустимый комментарий  (*  Больше не действительный комментарий!!

  *)

Компилятор будет реагировать с ошибкой "недопустимый символ", когда он встречает такие конструкции, независимо от переключателя ‑Mtp.

Замечание:

В режиме совместимости TP и Delphi, вложенные комментарии не допускаются, для максимальной совместимости с существующим кодом для этих компиляторов.