Rust на примерах

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

Каждая программа, безусловно, нуждается в комментариях и Rust предоставляет несколько способов комментирования кода:

  • Обычные комментарии, которые игнорируются компилятором:
    • // Однострочный комментарий. Который завершается в конце строки.
    • /* Блочный комментарий, который продолжается до завершающего символа. */
  • Doc комментарии, которые будут сгенерированы в HTML документацию:
    • /// Генерация документации для функции.
    • //! Генерация документации для модуля.
fn main() {
    // Это пример однострочного комментария
    // Обратите внимание на то, что строка комментария начинается с двух косых черт
    // Компилятор проигнорирует все, что написано внутри комментария

    // println!("Hello, world!");

    // Запустите данный код. Видите? Теперь попробуйте удалить комментарий и запустить еще раз.

    /* 
     * Это другой тип комментария - блочный. В целом, рекомендованным стилем
     * комментирования кода является однострочный комментарий, но блочный комментарий
     * является очень полезным в случае, когда необходимо проигнорировать какую-то 
     * большую часть кода. /* Блочные комментарии могут быть /* вложенными, */ */
     * так что комментирование всего кода в функции main займет всего пару нажатий
     * клавиш на клавиатуре. /*/*/* Попробуйте сами! */*/*/ 
     */

     /*
     Обратите внимание, что столбец из * в прошлом комментарие был добавлен
     для стиля. Он является необязательным. 
     */

     // Обратите внимание, как блочный комментарий позволяет легко управлять выражениями
     // однострочный комментарии не подходит для этой цели. Удалите блочный комментарий
     // и посмотрите, как изменится результат:
     let x = 5 + /* 90 + */ 5;
     println!("Is `x` 10 or 100? x = {}", x);
}

Смотрите также:

Library documentation