コメント

Swiftにおけるコメントは、コードの動作には影響を与えず、ソースコードに説明やメモを記述するために使用されます。コメントは可読性を高め、将来的なメンテナンスや他の開発者との共同作業を助ける重要な機能です。

Swiftのコメントには以下の2種類があります。


1. シングルラインコメント(一行コメント)

1行だけのコメントを記述する場合には、// を使います。//の右側に記述された内容は、その行の終わりまで無視されます。

例:

swift
// これは1行のコメントです let name = "Taro" // 変数nameに"Taro"を代入

2. マルチラインコメント(複数行コメント)

複数行にまたがるコメントを記述したい場合には、/**/ を使います。これらで囲まれた範囲はすべてコメントと見なされます。

例:

swift
/* この部分はすべてコメントとして扱われます。 複数行にわたる説明を書くのに便利です。 */ let age = 20

3. ネストされたコメント(入れ子のコメント)

Swiftの特徴として、マルチラインコメントを**ネスト(入れ子)**させることができます。これは多くの他の言語にはない機能です。

例:

swift
/* ここは最初のコメント /* これはネストされたコメント */ ここまでが最初のコメントの範囲 */

コメントの活用方法

  • 処理の意図や目的を説明する。

  • 仮実装コードやデバッグ用コードを一時的に無効化する。

  • 関数やクラスの仕様を説明する。

  • 後で修正・改善すべきポイントを明示する(例:// TODO:// FIXME: など)。

例:

swift
// TODO: 入力チェックの追加が必要 // FIXME: このロジックは最適化の余地あり

注意点

  • コメントは簡潔かつ的確に書くことが望ましい。

  • 古くなったコメントは、誤解を招くため定期的に見直す必要がある。

  • 過度なコメントは冗長になるため、コードの意図が明らかな場合は控えめにする。

生成日:2025/05/04