コメント
コメントはある種のコード内ドキュメントとしての機能を持ちます。 プログラム内に挿入されたとき、それらは実質的にコンパイラによって無視されます。 それらはソースコードを読む人間によって注釈として使用されることだけが意図されています。 コメントの具体的な内容は C++ 標準の一部ではありませんが、様々な形式でコメントを解析するユーティリティがいくつか存在します。
目次 |
[編集] 構文
/* comment */
|
(1) | ||||||||
// comment
|
(2) | ||||||||
すべてのコメントは、翻訳フェーズ3で、各コメントが1個のホワイトスペース文字で置き換えられることによって、除去されます。
[編集] C スタイル
C スタイルのコメントは、通常、大きなテキストブロックのコメントを書くために使用されますが、単一行のコメントを書くために使用することもできます。 C スタイルのコメントを挿入するには、単純に /* と */ でテキストを囲みます。 これでそのコメントの内容はコンパイラによって無視されるようになります。 C++ 標準の一部ではありませんが、ドキュメントブロックを示すために /** と */ がしばしば使用されます。 2つめのアスタリスクは単純にコメントの一部として扱われるので、これは合法です。 C スタイルのコメントはネストすることができません。
[編集] C++ スタイル
C++ スタイルのコメントは、通常、単一行のコメントを書くために使用されますが、複数行のコメントを書くために C++ スタイルのコメントを複数並べることもできます。 C++ スタイルのコメントは // と改行の間のすべての内容を無視するようコンパイラに指示します。
[編集] ノート
コメントはプリプロセッサステージより前に除去されるため、コメントを形成するためにマクロを使用することはできず、終了していない C スタイルのコメントが #include されたファイルから溢れ出ることもありません。
コメントアウトの他に、ソースコードを除外させるために使用される以下のような方法もあります。
#if 0 std::cout << "this will not be executed or even compiled\n"; #endif
また、以下のような方法もあります。
if(false) { std::cout << "this will not be executed\n" }
[編集] 例
/* C-style comments can contain multiple lines */ /* or just one */ // C++-style comments can comment one line // or, they can // be strung together int main() { // The below code won't be run // return 1; // The below code will be run return 0; }
[編集] 関連項目
| コメント の C言語リファレンス
|
