Главная » Java » Комментарии Java

0

 

Комментарии (comments) внутри кода используются только для удобства читателя. Они игнорируются компилятором и не оказывают влияния на результаты его работы. Существуют три формы комментариев – они перечислены в следующей таблице

 

 

// комментарий                                                                                 Символы после / / и до конца текущей строки игнори-                                                                                                      руются

 

/* комментарий */                                                        Все символы, заключенные между /* и */,                                                                                                                                              игнорируются

 

/** Комментарий */                                                     Все символы, заключенные между /** и                                                                                                                           */, игнорируются Эта конструкция комментария                                                                                                                  обычно предшествует объявлениям и автоматически                                                                                                          включается в документацию, получаемую с помощью                                                                                                специальных программ. Более подробные сведения                                                                                                       приведены в главе 14

 

 

——————————————————————————————————————————————————–

 

1 В языке программирования Java реализована спецификация Unicode версии 2.1 (с ис~ правлениями). За дополнительной информацией обращайтесь к разделу Список литературы, Приведенному в конце книги.

.

В состав комментариев могут быть включены любые символы Unicode, такие как, например, инь и янь (\u2б2f), созвездие (\u2042), лигатура из вопросительного и восклицательного знаков (\u20Зd), вона (\u20а9), скрупул (\u2108) или снеговик (\u2БОЗ).3

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

/* Надо подумать над этим на досуге

/* Не худо бы применить что-нибудь этакое */

universe.neatStuff();

* /

Первая пара символов /’~ открывает блок комментария, а ближайшая к ней * / закрывает его и тем самым указывает компилятору, что последующие символы свободны для анализа. Компилятор, встречая завершающую пару символов * /, воспринимает ее как лишнюю и указывает на ошибку синтаксиса. Наилучшиe способы временного удаления блоков кода программы таковы: следует либо поместить в начало каждой строки блока пару символов / /, либо облечь его в рамки заведомо "ложной" конструкции if(false)

if (false) {

// Разберусь как-нибудь потом

universe.neatstuff();

}

При использовании указанного выше приема, однако, требуется обеспечить достаточную полноту кода, чтобы гарантировать его безошибочную компиляцию. В нашем примере мы полагаем, что метод netStuff реально существует и объявлен в соответствующем доступном классе

 

Источник: Арнолд, Кен, Гослинг, Джеймс, Холмс, Дэвид. Язык программирования Java. 3-е изд .. : Пер. с англ. – М. : Издательский дом «Вильяме», 2001. – 624 с. : ил. – Парал. тит. англ.

По теме:

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