Комментарии

Практически все языки программирования позволяют оставлять в коде комментарии. Они никак не используются интерпретатором и нужны исключительно для людей: чтобы программист оставлял пометки для себя и для других программистов. Комментарии в Java бывают трёх видов:

Однострочные комментарии начинаются с //. После этих двух символов может следовать любой текст, вся строчка не будет анализироваться и исполняться.

Комментарий может занимать всю строчку:

// For Winterfell!

или может находиться на строчке после какого-нибудь кода:

System.out.print("I am the King"); // For Lannisters!

Многострочные комментарии начинаются с /* и заканчиваются на */. Принято каждую строчку начинать с символа *, хотя технически это и не обязательно.

/*
 * The night is dark and
 * full of terrors.
 */
System.out.print("I am the King");

Документирующие комментарии начинаются с /** и заканчивается на */ и уже для них уже обязательно каждую строчку начинать с символа *.

Документирующие комментарии, являясь, по сути, подвидом многострочных, несут дополнительную функцию – они могут быть собраны при помощи специальной утилиты javadoc и выданы в качестве документации к вашему коду. Мы поговорим о них позже – когда разберём классы и методы.

Задание

Создайте однострочный комментарий с текстом: You know nothing, John Snow!.


Советы

  • Если в редакторе есть запись // BEGIN и // END, то код нужно писать между этими строчками.

Определения

  • Комментарий — Текст в коде программы, который не влияет на функциональность и добавляется программистами для себя и своих коллег.

    // Однострочный комментарий

    /*
     * Многострочный
     * комментарий
     */
    /**
     * Документирующий
     * комментарий
     */

Нашли ошибку? Есть что добавить? Пулреквесты приветствуютсяhttps://github.com/hexlet-basics

Упражнение доступно только авторизованным пользователям.

Пожалуйста, авторизуйтесь с помощью учётной записи GitHub, это необходимо для отслеживания прогресса выполнения уроков. Если у вас ещё нет учётной записи, то сейчас самое время создать аккаунт на GitHub.