コメントとは?
|
コメントとは、コンピュータ言語(プログラミング言語やデータ記述言語)によって書かれたソースコードの内、人間のために覚えとして挿入された、注釈のことである。この部分は、コンピュータが処理を行うときには、ないものとして無視されるから、自由に文を挿入することができる。 どのような言語を用いてソースコードを書いたとしても、別の人が読んだり、同じ人であっても時間をおいてから読んだりした場合には、ソースコードからその意図を読みとることは困難である。従って、ソースコードの意図をコメントとしてソースコードに挿入することは、そのコードの保守において非常に重要である。 また、一時的にコンピュータに処理させたくない部分を、削除するかわりにコメントとすることもしばしば行われる。これをコメントアウトという。このとき、コメントアウトさせたい部分中にコメントが記述されている場合もあるため、構文的にコメントの入れ子が可能かどうかは大きな意味を持つ。 特殊な用途としては、ある言語を拡張したときに、古いヴァージョンではその部分を解釈させたくないときに、古いヴァージョンではその部分がコメントとして見えるように書くことがある。HTMLの中にJavaScriptを組み込む場合などがそれである。 コメントは、ある記号から行末までをコメントとして扱う行コメントと、2つの記号で前後を括り、その内部をコメントとして扱うブロックコメントに大別される。行コメントは、言語により、行のどこからでもコメントを開始できるものと、行頭にのみコメント開始記号を記述できるものがある。いずれにしても、行コメントは、行の途中でコメントを終了することができない、コメントが数行に渡る場合にも行ごとにコメントの開始を指示しなければならないといったデメリットがあるかわり、コメントの終了を指示しなくても良いというメリットがある。 BASICでは、REM、あるいは ' (アポストロフィ)より後がコメントと見なされる。ただし、REM は命令のひとつであるから、これを用いて行の途中からコメントとする場合には、その前に : を置いてマルチステートメント(1行に複数の命令を書くこと)の形にしなければならない。一方、' は :REM の省略形と見なされるため、その前に : を置く必要はない。 各種シェルスクリプトやそれらの概念を継承しているPerlやPythonでは、# 以降がコメントと見なされる。また、ファイルの先頭にある #! から開始するコメントは、慣例的にそのスクリプトを実行するプログラムを指定するものとして扱われる。 MS-DOSのバッチファイルでは、REM、あるいは ::、: (コロン2つ、コロン+半角スペース)で始まる行がコメントと見なされる。コロンで始まる行は本来ラベルの宣言を行うものだが、解説書ではしばしばコメントと見なされる例として取り上げられる。 C、C++、Java、JavaScript、CSSでは、/* と */ で括る。また、Javaでは /** と */ で括られたコメントをドキュメントとして扱う。これは、Javadocというツールを用いてこのコメントのみを抽出し、ドキュメントを生成する仕組みに使用されている。 また、コンピューター言語以外のものを扱うアプリケーションソフトでも、コメント同様の機能が利用できる場合がある。ワードプロセッサソフトや表計算ソフトにおける「コメント」、「付箋」などの機能がそれである。 これらコメントはプログラムソースの保守管理に欠かせないものであり、特にプログラム内にドキュメントを含ませる事で、チームを組んで保守したり、または担当者が変った後でも保守・改良、またはバグ修正に大きな力を発揮する。 ただ、稀にこのコメントに落書きをするプログラマーも見られ、実用に供されるプログラムにあっても、本来のプログラム動作には関係の無いコメントを残す人も見られる。コンピュータウイルスのMyDoomやBagleとNetSkyの系列に於いて、そのソース内のコメントで罵り合った事例が知られている。 オープンソース分野でも、簡潔に要点を述べるコメントはプログラムを参考にしやすいとして歓迎される一方、ただ冗長なだけのコメントに「記憶領域を無駄に浪費するだけで、読み辛い」と苦言を呈する人も見られる。 |
[ 29] コメント (コンピュータ) - Wikipedia
[引用サイト] http://ja.wikipedia.org/wiki/%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88_(%E3%82%B3%E3%83%B3%E3%83%94%E3%83%A5%E3%83%BC%E3%82%BF)
|
^このページは一部にJavaScriptを使用しています。JavaScriptを有効に設定してご利用ください。 環境省では国民のみなさんの意見を行政に反映させるため、法令や法令に基づく基準の制定・改廃等に当たっては、ホームページを通じて、広く意見を募集しています。 また、ここに掲載している案件以外でも、環境政策に関するご提言をMOEメールで受け付けております。 H19.11.30締切「2007年度 自主行動計画フォローアップ結果及び今後の課題等(案)」に対する意見の募集 H19.12.16締切遺伝子組換え生物等の使用等の規制による生物多様性の確保に関する法律に基づく第一種使用規程の承認申請案件に対する意見の募集 H19.12.12締切「特定外来生物による生態系等に係る被害の防止に関する法律」に基づく特定外来生物に係る特定飼養等施設の基準の細目等の改正に関する意見の募集 H19.12.12締切遺伝子組換え生物等の使用等の規制による生物多様性の確保に関する法律に基づく第一種使用規程の承認申請案件に対する意見の募集 H19.12.09締切「自動車排出窒素酸化物及び自動車排出粒子状物質の総量の削減に関する基本方針」の変更案に対する意見の募集について H19.12.05締切特定物質の規制等によるオゾン層の保護に関する法律施行令の一部を改正する政令案に関する意見の募集について H19.12.04締切食品衛生法に基づく魚介類への残留基準の設定に対応した水質汚濁に係る農薬登録保留基準の改定について(中央環境審議会土壌農薬部会農薬小委員会報告案)等に関する意見の募集について H19.12.04締切湖沼水質保全特別措置法第3条第1項及び第2項の規定に基づく指定湖沼及び指定地域(告示)案並びに湖沼水質保全特別措置法施行令の一部を改正する政令案に対する意見の募集について 「2007年度 自主行動計画フォローアップ結果及び今後の課題等(案)」に対する意見の募集(パブリックコメント)について 遺伝子組換え生物等の使用等の規制による生物多様性の確保に関する法律に基づく第一種使用規程の承認申請案件に対する意見の募集 遺伝子組換え生物等の使用等の規制による生物多様性の確保に関する法律に基づく第一種使用規程の承認申請案件に対する意見の募集(パブリックコメント)ついて 「特定外来生物による生態系等に係る被害の防止に関する法律」に基づく特定外来生物に係る特定飼養等施設の基準の細目等の改正に関する意見の募集 返信用封筒(長3形、住所氏名を明記。90円切手を貼付のこと。)を同封の上、環境省自然環境局野生生物課外来生物対策室まで郵送願います。 「特定外来生物による生態系等に係る被害の防止に関する法律」に基づく特定外来生物に係る特定飼養等施設の基準の細目等の改正に関する意見の募集(パブリックコメント)について 遺伝子組換え生物等の使用等の規制による生物多様性の確保に関する法律に基づく第一種使用規程の承認申請案件に対する意見の募集(パブリックコメント)について 遺伝子組換え生物等の使用等の規制による生物多様性の確保に関する法律に基づく第一種使用規程の承認申請案件に対する意見の募集(パブリックコメント)について 「自動車排出窒素酸化物及び自動車排出粒子状物質の総量の削減に関する基本方針」の変更案に対する意見の募集について 「自動車排出窒素酸化物及び自動車排出粒子状物質の総量の削減に関する基本方針」の変更案に対する意見の募集について 特定物質の規制等によるオゾン層の保護に関する法律施行令の一部を改正する政令案に関する意見の募集について 「特定物質の規制等によるオゾン層の保護に関する法律施行令」の一部改正に対する意見募集について(お知らせ) 食品衛生法に基づく魚介類への残留基準の設定に対応した水質汚濁に係る農薬登録保留基準の改定について(中央環境審議会土壌農薬部会農薬小委員会報告案)等に関する意見の募集について 食品衛生法に基づく魚介類への残留基準の設定に対応した水質汚濁に係る農薬登録保留基準の改定について(中央環境審議会土壌農薬部会農薬小委員会報告案)等に関する意見の募集について 湖沼水質保全特別措置法第3条第1項及び第2項の規定に基づく指定湖沼及び指定地域(告示)案並びに湖沼水質保全特別措置法施行令の一部を改正する政令案に対する意見の募集について 湖沼水質保全特別措置法第3条第1項及び第2項の規定に基づく指定湖沼及び指定地域(告示)案並びに湖沼水質保全特別措置法施行令の一部を改正する政令案に対する意見の募集について |
[ 30] パブリックコメント
[引用サイト] http://www.env.go.jp/info/iken.html
