Програмування на мові Java Введення в мову Java
March 12th, 2009
« Програмування на мові Java Революція на імя Java | Java - як все починалося »
Хоча коментарі ніяк не впливають на виконуваний код програми, при правильному використанні вони виявляються вельми істотною частиною початкового тексту. Існує три різновиди коментарів: коментарі в одному рядку, коментарі в декількох рядках і, нарешті, коментарі для документування.
Коментарі, що займають один рядок, починаються з символів // і закінчуються в кінці рядка. Такий стиль коментування корисний для розміщення коротких пояснень до окремих рядків коду:
а = 42; // якщо 42-ответ, то яке ж було питання?
Для докладніших пояснень ви можете скористатися коментарями, розміщеними на декількох рядках, почавши текст коментарів символами /* і закінчивши символами */ При цьому весь текст між цими парами символів буде розцінений як коментар і транслятор його проігнорує.
/* * Цей код декілька хитромудрий… * Спробую пояснити: * …. */
Третя, особлива форма коментарів, призначена для сервісної програми javadoc, яка використовує компоненти Java-транслятора для автоматичної генерації документації по інтерфейсах класів.
Угода, використовувана для коментарів цього вигляду, таке: для того, щоб розмістити перед оголошенням відкритого (public) класу, методу або змінної документуючий коментар, потрібно почати його з символів /** (коса межа і дві зірочки). Закінчується такий коментар точно так, як і звичайний комментарій-символамі */.
Програма javadoc уміє розрізняти в документуючих коментарях деякі спеціальні змінні, імена яких починаються з символу @. Ось приклад такого коментаря:
/** * Цей клас уміє робити чудові речі. Радимо всякому, хто * захоче написати ще більш довершений клас, узяти його в якості * базового. * @see Java. applet. Applet * (c)author Patrick Naughton * @version 1.
2 */ class CoolApplet extends Applet { /** * У цього методу два параметри: * @param key-это ім’я параметра. * @param value-это значення параметра з ім’ям key. */ void put (String key, Object value) {
Зарезервовані ключові слова
Pages: 1 2 3 4 5 6 7 8 9 10 11
Tags: значення, клас, метод, програма, рядок, символ, число
програмування
Схожі записи
Категория: програмування |










