Comments

Comments / Komentar berguna untuk dibaca oleh programmer, bukan untuk komputer. Adalah hal yang baik untuk menulis komentar agar orang lain menjadi mudah untuk membaca code yang telah dibuat. Hal ini juga bagus untuk membantu diri kita sendiri mengerti code yang telah kita buat. (Banyak orang yang sudah menulis code programnya dengan mantap, namun seiring waktu berjalan, dan dia mulai membaca lagi code yang sudah lama sudah tidak dia sentuh, mereka lupa mengapa mereka menulis bagian tersebut.)

Untuk menulis komentar di Rust, Anda biasanya menggunakan //:

fn main() {
    // Program Rust dimulai dengan fn main()
    // Kita menuliskan codenya di dalam sebuah block. Block diawali dengan { dan diakhiri dengan }
    let some_number = 100; // Kita bisa menulis sebanyak yang kita mau disini dan compiler tidak akan membacanya
}

Apabila Anda menjalankan code tersebut, compiler akan mengabaikan apapun yang tertulis setelah //.

Ada pula cara berbeda untuk menulis komentar, yaitu dengan cara menulis /* pada bagian awalnya dan */ pada bagian akhirnya. Cara menulis komentar seperti ini sangat berguna apabila kita ingin menulis komentar pada bagian tengah dari baris code anda.

fn main() {
    let some_number/*: i16*/ = 100;
}

Bagi compiler, let some_number/*: i16*/ = 100; terlihat sama dengan let some_number = 100;.

Format /* */ juga sangat berguna untuk komentar yang panjang (lebih dari 1 baris). Pada contoh ini, Anda bisa melihat bahwa Anda perlu menuliskan // untuk setiap baris. Namun jika Anda menggunakan /*, apa yang ditulis setelahnya akan tetap dianggap komentar, sampai ia ditutup dengan */.

fn main() {
    let some_number = 100; /* Let me tell you
    a little about this number.
    It's 100, which is my favourite number.
    It's called some_number but actually I think that... */

    let some_number = 100; // Let me tell you
    // a little about this number.
    // It's 100, which is my favourite number.
    // It's called some_number but actually I think that...
}