Types of Comments

1. Single-Line Comment

   In C++, a single-line comment begins with //. Anything written after // on that line is ignored by the compiler. It is used for writing short notes or explaining one line of code.

   Example:

   // This is a single-line comment
   #include <iostream>
   using namespace std;
   
   int main() {
       cout << "Hello, From ShikshaSanchar!" << endl; // Prints message
       return 0;
   }

   Output:

   Hello, From ShikshaSanchar!

   Explanation:

   • // This is a single-line comment is ignored by the compiler.
   • The comment after the cout statement explains what that line does.
   • These are best for short and quick explanations in code.

2. Multi-Line Comment

   A multi-line comment starts with /* and ends with */. Everything between these symbols is ignored by the compiler. They are useful for detailed notes or stopping multiple lines of code from running.

   Example:

   /* This is a multi-line comment
      It can cover many lines
      and is ignored by the compiler */
   #include <iostream>
   using namespace std;
   
   int main() {
       cout << "Welcome to ShikshaSanchar C++ Course!" << endl;
       return 0;
   }

   Output:

   Welcome to ShikshaSanchar C++ Course!!

   Explanation:

   • Text between /* and */ is ignored completely.
   • They are useful when we want to write bigger notes or disable a block of code.

Best Practices for Writing Comments

Example with Comments:

In this program, two predefined marks are added together. Comments are written to explain each step clearly.

// Program to calculate total marks
#include <iostream>
using namespace std;

int main() {
    int marks1 = 50;  // marks in first subject
    int marks2 = 40;  // marks in second subject

    // Adding the marks
    int total = marks1 + marks2;

    // Printing the result
    cout << "The total marks are: " << total << endl;

    return 0;
}