C Language
コメント

前書き

構文

• /*...*/
• //... （C99以降のみ）

/ * * /区切られたコメント

コメントはスラッシュ、アスタリスク（ /* ）で始まり、アスタリスクの直後にスラッシュ（ */ ）が続くとすぐに終了します。これらの文字の組み合わせの間のすべてがコメントであり、コンパイラによって空白（基本的に無視される）として扱われます。

/* this is a comment */

上記のコメントは一行コメントです。この/*型のコメントは、次のように複数の行にまたがることができます：

/* this is a
multi-line
comment */

厳密には必要ではありませんが、複数行のコメントを使用する一般的なスタイル規則では、最初の行に続く空白とアスタリスクを新しい行に/*と*/を付けて並べます。

/* 
 * this is a
 * multi-line
 * comment
 */

余分なアスタリスクは、コメントに機能的な影響を及ぼさず、関連するスラッシュはありません。

これらの/*タイプのコメントは、それぞれの行、コード行の最後、またはコード行内で使用することができます。

/* this comment is on its own line */
if (x && y) { /*this comment is at the end of a line */
    if ((complexCondition1) /* this comment is within a line of code */
            && (complexCondition2)) {
        /* this comment is within an if, on its own line */
    }
}

コメントはネストできません。これは、その後の/*は（コメントの一部として）無視され、最初の*/がコメントの終了として扱われるためです。次の例のコメントは機能しません 。

/* outer comment, means this is ignored => /* attempted inner comment */ <= ends the comment, not this one => */

このタイプのコメントを含むコードのブロックをコメントするには、そうでなければネストされます。以下の「プリプロセッサを使用したコメントの例」を参照してください。

//区切られたコメント

// this is a comment

// each of these lines are a single-line comment
// note how each must start with
// the double forward-slash

// this comment is on its own line
if (x && y) { // this comment is at the end of a line
    // this comment is within an if, on its own line
}

プリプロセッサを使ったコメント

大量のコードは、プリプロセッサディレクティブ#if 0と#endifを使用して "コメントアウト"することもできます。これは、コードに複数行のコメントが含まれていて、それ以外の場合にはネストされない場合に便利です。

#if 0 /* Starts the "comment", anything from here on is removed by preprocessor */ 

/* A large amount of code with multi-line comments */  
int foo()
{
    /* lots of code */
    ...

    /* ... some comment describing the if statement ... */
    if (someTest) {
        /* some more comments */
        return 1;
    }

    return 0;
}

#endif /* 0 */

/* code from here on is "uncommented" (included in compiled executable) */
... 

トリグラフによる落とし穴

int x = 20;  // Why did I do this??/

int foo = 20; // Start at 20 ??/
int bar = 0;

// The following will cause a compilation error (undeclared variable 'bar')
// because 'int bar = 0;' is part of the comment on the preceding line
bar += foo;