Коментарі
Кожна програма потребує коментарів, і Rust підтримує кілька різних різновидів:
Звичайні коментарі
Вони ігноруються компілятором:
- Покоментарні рядки: Починаються з
//і тривають до кінця рядка - Блокові коментарі: Укладені в
/* ... */і можуть охоплювати кілька рядків
Документаційні коментарі (Doc Comments), які розбираються в HTML library documentation:
///- Генерує документацію для елемента, що слідує за ним//!- Генерує документацію для елемента, що охоплює його (зазвичай використовується на початку файлу або модуля)
fn main() {
// Покоментарні рядки починаються з двох слешів.
// Усе після слешів ігнорується компілятором.
// Приклад: цей рядок не виконається
// println!("Hello, world!");
// Спробуйте видалити слеші вище й запустити код знову.
/*
* Блокові коментарі корисні для тимчасового вимкнення коду.
* Їх також можна вкладати: /* like this */ що робить простим
* швидке коментування великих фрагментів.
*/
/*
Примітка: колонка зірочок ліворуч — це лише для стилю -
вона не є обов'язковою для мови.
*/
// Блокові коментарі роблять простим вмикання/вимикання коду шляхом додавання
// або видалення лише одного слеша:
/* <- Додайте тут '/' , щоб розкоментувати весь блок нижче
println!("Now");
println!("everything");
println!("executes!");
// Покоментарні рядки всередині залишаються без змін
// */
// Блокові коментарі також можна використовувати всередині виразів:
let x = 5 + /* 90 + */ 5;
println!("Is `x` 10 or 100? x = {}", x);
}