C/C++におけるコメントの書き方と使い方

コメントとは、コンパイラによって無視されるコードの一部分のことです。コメントを適切に活用することで、コードの可読性と理解しやすさが大幅に向上します。C++言語では、単一行コメントと複数行コメントのどちらも同じように機能します。

C/C++におけるコメントの種類

C/C++では主に2種類のコメントが使えます。

• 単一行コメント：「//」から行末までがコメントとして扱われます。
• 複数行コメント：「/*」から「*/」までの間がすべてコメントとして扱われます。

// 単一行コメント

/*
複数行コメント
*/

以下は、C言語におけるコメントの使用例です。

使用例

#include <stdio.h>
#include <string.h>
int main () {
    /* データメンバーの宣言 */
    char s[10] = "HelloWorld";
    char d[10];
    int n;
    n = strxfrm(d, s, 5);
    printf("Length of string : %d", n); // 文字列の長さを出力
    return(0);
}

実行結果

Length of string : 10

上記のプログラムでは、単一行コメントと複数行コメントの両方が使用されています。このプログラムは、strxfrm関数を使って文字列の一部をコピー先へ転送する処理を行っています。

/* データメンバーの宣言 */
char s[10] = "HelloWorld";
char d[10];
int n;
n = strxfrm(d, s, 5);
printf("Length of string : %d", n); // 文字列の長さ

まとめ

コメントはプログラムの動作には一切影響しませんが、コードの意図や処理内容を説明するうえで非常に重要な要素です。特にチーム開発では、他の開発者がコードを素早く理解できるようになるため、適切な位置にわかりやすいコメントを残す習慣をつけることをおすすめします。