Коментарі

Всі програмісти прагнуть зробити свій код зрозумілішим, та деколи не завадить додаткове пояснення. В таких випадках програмісти лишають в початковому коді коментарі, які ігнорує компілятор, але які можуть бути корисними людям, що читатимуть цей код.

Ось простий коментар:

#![allow(unused)]
fn main() {
// hello, world
}

У Rust найтиповіший стиль коментарів починається з двох знаків дробу і продовжується до кінця рядка. Для коментарів, що займають більше одного рядка, вам доведеться ставити // у кожному рядку, ось так:

#![allow(unused)]
fn main() {
// Тут ми робимо щось складне, досить довге, щоб нам знадобилося кілька рядків
// коментаря! Хух! Сподіваюся, цей коментар достатньо детально пояснює, що 
// тут відбувається.
}

Коментарі також можна розміщувати в кінці рядків, що містять код:

Файл: src/main.rs

fn main() {
    let lucky_number = 7; // I’m feeling lucky today
}

Та частіше ви бачитимете їх у форматі, де коментар знаходиться в окремому рядку перед кодом, якого він стосується:

Файл: src/main.rs

fn main() {
    // I’m feeling lucky today
    let lucky_number = 7;
}

Rust також має інший вид коментарів, документаційні коментарі, які ми обговоримо в підрозділі "Публікація крейта на Crates.io" Розділу 14.