本文へ移動

ちゅうしゃく

注釈

別称: コメント

プログラムのソースコード内に記述される、人間向けの補足説明です。

詳しい説明

注釈とは、プログラムのソースコードやドキュメントの中に記述される、人間が読みやすくするための補足説明のことです。コンピュータはこの部分をプログラムとして実行することはないため、処理結果には一切影響を与えません。

その仕組みは、使用するプログラミング言語ごとの特定の記号(例:// や /* */)で囲むことで、ソースコードの一部として記述します。注釈は、なぜそのコードを書いたのか、どのような処理を行っているのかを他者が理解するために不可欠です。適切な注釈があることで、メンテナンス性が向上し、修正作業時のバグ混入リスクを減らすことができます。

混同しやすいのは、コードそのものの品質との違いです。注釈は重要ですが、コード自体が複雑すぎると注釈を読んでも理解できない場合があります。良いコードは注釈がなくても意図が伝わるものですが、複雑なアルゴリズムや特殊な処理には注釈が必須です。試験では、コードの可読性を高める手段としての役割が問われます。

試験で問われること

ITパスポート試験

  • プログラムの可読性を高める工夫としての重要性を理解する。
  • メンテナンス性向上という目的を把握する。

基本情報技術者試験

  • 適切な注釈の付け方とコード品質の関係を理解する。
  • ドキュメンテーションの一部としての役割を把握する。
  • ソースコード管理と注釈の意義を関連づける。