The Rust Programming Language

Chú thích

Mọi 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 thêm giải thích. Trong những trường hợp đó, lập trình viên để lại chú thích trong mã nguồn mà trình biên dịch sẽ bỏ qua nhưng người đọc mã có thể thấy hữu ích.

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

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

Trong Rust, kiểu chú thích theo phong cách chuẩn bắt đầu một chú thích bằng hai dấu gạch chéo, và chú thích sẽ kéo dài đến cuối dòng. Với chú thích vượt quá một dòng, bạn sẽ cần thêm // ở mỗi dòng, như sau:

#![allow(unused)]
fn main() {
// So we're doing something complicated here, long enough that we need
// multiple lines of comments to do it! Whew! Hopefully, this comment will
// explain what's going on.
}

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

Filename: 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 dùng theo dạng này hơn, với chú thích nằm trên một dòng riêng phía trên đoạn mã mà nó ghi chú:

Filename: src/main.rs

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

Rust còn có một loại chú thích khác, chú thích tài liệu (documentation comments), 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.