<MyRusakov.ru />

Программирование на Python с Нуля до Гуру

Программирование на Python с Нуля до Гуру

Данный курс научит Вас программировать на языке Python, который крайне желательно знать любому, кто хоть иногда имеет дело с компьютерами. Курс состоит из 6 разделов, в которых Вы с нуля освоите этот язык и сможете создавать самые разные программы для самых разных задач любой сложности.

К курсу прилагается множество упражнений и все исходники из уроков.

Наконец, Вы получите ещё несколько бонусов: "Создание калькулятора на Python", "Создание игры на Python" и "Правильная работа со справочником".

Подробнее
Подписка

Подписавшись по E-mail, Вы будете получать уведомления о новых статьях.

Подписка Подписаться

Добавляйтесь ко мне в друзья ВКонтакте! Отзывы о сайте и обо мне оставляйте в моей группе.

Мой аккаунт Мой аккаунт Моя группа
Опрос

Каким движком Вы предпочитаете пользоваться?

Комментарии в Java коде

Комментарии в Java коде

Написание качественных программ не обходится без комментирование кода. Комментирование кода - это полезная привычка с помощью которой можно убить сразу двух зайцев:

  1. комментируя код Вы в последствии сможете быстро понять о чем идет речь, когда вернетесь к коду через некоторое время
  2. грамотные и понятные комментарии можно сразу оформлять в стиле javadoc. Затем по всем классам проекта можно автоматически сформировать документацию, если появится потребность выставить код на всеобщее обозрение. Таким образом, не придется тратить время на написание документации к проекту.

В Java, как и в PHP присутствует несколько видов комментариев, каждый из которых может быть полезен в определенных случаях.

Итак, рассмотрим простейшую программу на Java, которая содержит комментарии:

/**
 * Данный комментарий описывает класс MyrusakovApp
 * текст комментария может располагаться на нескольких строках
 */
class MyrusakovApp {

    /**
    * Главный метод 
    *
    * @return void - один из специальных маркер в javadoc для обозначения возвращаемого значения
    */
    public static void main(String[] args) {
        System.out.println("Author: Myrusakov!"); // Однострочный комментарий - Отображает строку.
    }
}

В Java существуют следующие виды комментариев:


/* простой текст. все что внутри игнорируется компилятором */

/** 
 *  комментарий документации
 *  
 * с помощью него создается комментарий документирования. Компилятор игнорирует все что находится внутри данного комментария
 * Утилита javadoc использует этот тип комментариев для автогенерации документации. Необходимые параметры задаются с помощью
 * специальных терминов
 *
 */

// Просто однострочный комментарий, который распространяется до конца строки

Таким образом, комментарии - это очень важный и нужный инструмент, для использования которого надо просто выработать привычку, которая даст свои плоды в будущем.

Копирование материалов разрешается только с указанием автора (Михаил Русаков) и индексируемой прямой ссылкой на сайт (http://myrusakov.ru)!

Добавляйтесь ко мне в друзья ВКонтакте: http://vk.com/myrusakov.
Если Вы хотите дать оценку мне и моей работе, то напишите её в моей группе: http://vk.com/rusakovmy.

Если Вы не хотите пропустить новые материалы на сайте,
то Вы можете подписаться на обновления: Подписаться на обновления

Если у Вас остались какие-либо вопросы, либо у Вас есть желание высказаться по поводу этой статьи, то Вы можете оставить свой комментарий внизу страницы.

Порекомендуйте эту статью друзьям:

Если Вам понравился сайт, то разместите ссылку на него (у себя на сайте, на форуме, в контакте):

  1. Кнопка:

    Она выглядит вот так: Как создать свой сайт

  2. Текстовая ссылка:

    Она выглядит вот так: Как создать свой сайт

  3. BB-код ссылки для форумов (например, можете поставить её в подписи):

Комментарии (0):

Для добавления комментариев надо войти в систему.
Если Вы ещё не зарегистрированы на сайте, то сначала зарегистрируйтесь.