পাঠ ৩.৪

Comment

Comments

Code পড়ার সময় কখনো কখনো extra explanation দরকার হয়। তখন আমরা comment লিখি — compiler এগুলো ignore করে, কিন্তু পরবর্তী reader-এর জন্য সাহায্যকারী।

Single-line comment

Rust-এর idiomatic comment style — দুটো slash // দিয়ে শুরু, line-এর শেষ পর্যন্ত comment।

// hello, world

Multi-line comment

এক line-এর বেশি comment চাইলে প্রতিটা line-এ // দিতে হয়:

// 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.

(C/C++-এর /* ... */ style block comment-ও Rust-এ আছে, তবে কম use হয়।)

Line-শেষে বা line-এর উপরে?

Code-এর শেষে comment বসানো যায়:

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

কিন্তু Rust community-তে এটা কম প্রচলিত। সাধারণত comment আলাদা line-এ, যেটা explain করছে তার ঠিক উপরে:

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

Documentation comment

Rust-এ আরেক ধরনের comment আছে — documentation comment (/// বা //! দিয়ে শুরু)। এগুলো special — cargo doc দিয়ে HTML documentation generate করা যায়। বিস্তারিত Chapter 14-এ ("Publishing a Crate to Crates.io") আসবে।

এই পাঠ থেকে যা শিখলে

  • // — single-line comment (এই same syntax-ই multiple line-এ repeat করতে হয়)।
  • Rust style — comment আলাদা line-এ, code-এর ঠিক উপরে।
  • /// doc comment আছে — chapter 14-এ বিস্তারিত।