コメント (コンピュータ)
代表的なブロックコメントには以下のようなものがある。
HTML、Wikiでは、原則として、<!--と-->で括る。また、HTMLではバージョンによって <comment> と </comment> で括ることもできる。タグ(< と >で括られた部分)の内部でコメントを作るには、-- と -- で括るが、HTML 4.0以前のバージョンでなければならない。
C、C++、Java、C#、JavaScript、CSSなどでは、/* と */ で括る。また、Javaでは /** と */ で括られたコメントをドキュメントとして扱う。これは、Javadocというツールを用いてこのコメントのみを抽出し、ドキュメントを生成する仕組みに使用されている。
Dでは、/+と+/で囲むコメントがある。このコメント形式を使用することで、コメントを入れ子にすることができる。
Pascalでは、{ と } で括る。なお、{ や } が文字コードとして定義されていない(主に初期の)コンピュータのために、(* と *) で括る代替記法もある。
Perl(version 5 以降)の正規表現では (?# と ) で括る。
Mathematicaでは、(* と *) で括る。
C/C++およびC#では、プリプロセッサディレクティブの#if - #endifが、ブロックコメントの代用として使われることもある。ディレクティブは入れ子にすることができ、また簡単にコードの有効化/無効化を切り替えることができるというメリットがある一方、多用すると「どのコードが有効であるか」が一見して判別しにくくなるというデメリットもある。
代表的な行コメントには以下のようなものがある。基本的に半角(ASCII)の英数字や記号が開始トークンとして使用される。
C(C99以降)、C++、Java、C#、JavaScriptなどでは、2連のスラッシュ // 以降がコメントと見なされる。
BASICでは、REM、あるいはシングルクォーテーション ' より後がコメントと見なされる。ただし、REM は命令のひとつであるから、これを用いて行の途中からコメントとする場合には、その前にコロン : を置いてマルチステートメント(1行に複数の命令を書くこと)の形にしなければならない。一方、' は :REM の省略形と見なされるため、その前に : を置く必要はない。
各種シェルスクリプト、およびそれらの概念を継承しているPerlやPython、Rubyでは、ナンバーサイン # 以降がコメントと見なされる。また、ファイルの先頭にある #! から開始するコメントは、慣例的にそのスクリプトを実行するプログラムを指定するものとして扱われる(シバン)。
AdaやSQL、Luaでは、2連のハイフンマイナス -- 以降がコメントと見なされる。
Common LispやScheme、x86アセンブリ言語ではセミコロン ; 以降がコメントと見なされる。
マイクロソフト仕様のINIファイルでは、行頭にセミコロン ; があると行末まで無視される。
MS-DOSのバッチファイルでは、REM、2連のコロン::、あるいはコロン+スペース: で始まる行がコメントと見なされる。コロンで始まる行は本来ラベルの宣言を行うものだが、解説書ではしばしばコメントと見なされる例として取り上げられる。