English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Kotlin コメント

この記事では、Kotlinのコメントとそれらの使用方法、理由について説明します。

プログラミングでは、コメントはプログラムの一部であり、あなたや他のプログラマーがコードを理解するためにあります。Kotlinコンパイラ(コンパイラ)はそれらを完全に無視します。

Javaと同様に、Kotlinには2種類のコメントがあります。

  • /* ... */

  • // ....

伝統的なコメント / * ... * /

これは多行コメントで、複数の行を越えることができます。Kotlinコンパイラは以下の行から省略します。 /*  までの  */すべての内容です。例えば、

/* これは多行コメントです。
 * 「Hello,World!」を標準出力にプリントアウトします。
 */
fun main(args: Array<String>) {
   println("Hello, World!")
}

伝統的なコメントもKotlinコード(KDoc)の記録に使用され、少し変化しています。KDocコメントは以下の形式で/ **の始まり、以下の形式で* /の終わり。

行末のコメント //

コンパイラは、以下の行から省略します。 // 行末までのすべての内容 。例えば、

// Kotlin Hello World プログラム
fun main(args: Array<String>) {
   println("Hello, World!")      // Hello, World!を出力する
}

上記のプログラムには、行末コメントが2つあります:

// Kotlin Hello World プログラム

および

// Hello, World!を出力する

コメントの適切な使用

コメントは、英語で書かれた悪いコードを説明する方法に代わるべきではありません。構造がよくて読みやすいコードを書き、それにコメントを追加するべきです。

ほとんどのケースで、コメントは「なぜ」を説明するために使われ、その点に従えば十分です。