Ngôn ngữ lập trình Rust

Chú thích

Tất cả các lập trình viên đều cố gắng làm cho mã của họ dễ hiểu, nhưng đôi khi cần có những giải thích thêm. Trong những trường hợp này, lập trình viên để lại chú thích (comments) trong mã nguồn mà trình biên dịch sẽ bỏ qua nhưng người đọc mã nguồn có thể thấy hữu ích.

Đây là một chú thích đơn giản:

#![allow(unused)]
fn main() {
// xin chào, thế giới
}

Trong Rust, phong cách chú thích thông dụng bắt đầu bằng hai dấu gạch chéo, và chú thích tiếp tục đến hết dòng. Đối với các chú thích kéo dài hơn một dòng, bạn cần phải thêm // ở mỗi dòng, như thế này:

#![allow(unused)]
fn main() {
// Chúng ta đang làm một điều gì đó phức tạp ở đây, đủ dài để chúng ta cần
// nhiều dòng chú thích để làm điều đó! Ồ! Hy vọng rằng, chú thích này sẽ
// giải thích những gì đang diễn ra.
}

Chú thích cũng có thể được đặt ở cuối dòng chứa mã:

Tên tệp: src/main.rs

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

Nhưng bạn sẽ thường thấy chúng được sử dụng trong định dạng này, với chú thích trên một dòng riêng phía trên mã mà nó đang chú thích:

Tên tệp: src/main.rs

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

Rust cũng có một loại chú thích khác, chú thích tài liệu, mà chúng ta sẽ thảo luận trong phần "Xuất bản một Crate lên Crates.io" của Chương 14.