Mastering Comments in C: Writing Clear, Effective Notes

What Is a Comment in C?

A comment is an explanation or description that accompanies source code. It helps developers communicate intent, improve readability, and maintain code over time. During compilation, the compiler simply ignores comments, so they do not affect runtime performance.

In C there are two canonical styles:

1. Block comments, starting with /* and ending with */. They can span a single line or multiple lines.
2. Single‑line comments, introduced by //. Anything following the two slashes on that line is discarded by the compiler.

Single‑Line Comment Example

// This is a single‑line comment

Below is a minimal program that demonstrates the use of a single‑line comment:

#include <stdio.h>

int main(void)
{
    // The following prints a greeting
    printf("Guru99");
    return 0; // Exit status
}

Multi‑Line Comment Example

/* Sample multi‑line comment
   Line 1
   Line 2
   ...
*/

Here is a real‑world snippet that mixes block comments with inline single‑line comments:

#include <stdio.h>

int main()
{
    /* In the main function I describe the logic
       and highlight key steps */
    int x = 42; // x is an integer variable
    printf("%d", x);
    return 0;
}

Why Should You Comment?

Writing code that is readable by humans is a cornerstone of professional software development. Comments:

• Clarify complex logic for future maintainers.
• Document assumptions, constraints, and expected behavior.
• Facilitate collaboration in teams and open‑source projects.
• Do not impact program execution, yet provide long‑term value.

Adopting disciplined commenting habits is considered a best practice in the industry and signals expertise, diligence, and a commitment to quality.