| Комментарии в Java, как и в большинстве языков программирования, игнорируются при выполнении программы. Таким образом, в программу можно добавить столько комментариев, сколько потребуется, не опасаясь увеличить ее объем. В Java предоставляются три способа выделения комментариев в тексте. Чаще всего для этой цели используются две косые черты (//), а комментарий начинается сразу за символами //и продолжается до конца строки. Если же требуются комментарии, состоящие из нескольких строк, каждую их строку следует начинать символами //, как показано ниже.
System.out.println("We will not use 'Hello, World!'");
// Мы не будем пользоваться избитой фразой "Здравствуй, мир!".
// Остроумно, не правда ли?
Кроме того, для создания больших блоков комментариев можно использовать разделители /* и */. И наконец, третьей разновидностью комментариев можно пользоваться для автоматического формирования документации. Эти комментарии начинаются символами /** и заканчиваются символами */, как показано в листинге 3.1. Подробнее об этой разновидности комментариев и автоматическом формировании документации речь пойдет в главе 4.
Листинг3.1. Исходный код из файла FirstSample/FirstSample. java
1 /**
2 * Это первый пример программы в главе 3
3 * Aversion 1.01 1997-03-22
4 * @author Gary Cornell
5 */
6 public class FirstSample
7 {
8 public static void main(String[] args)
9 {
10 System.out.println("We will not use 'Hello, World!'");
11 }
12 }
ВНИМАНИЕ! В Java комментарии, выделяемые символами /* и */, не могут быть вложенными. Это означает, что фрагмент кода нельзя исключить из программы, просто закомментировав его парой символов /* и */, поскольку в этом коде могут, в свою очередь, присутствовать разделители /* и */. |
Главная
Каталог файлов
