Топ-10 конкурентов blog.katty.in

srcw.net

小規模なプログラミング生活を綴ります

tech.la-fra.com

結構前からパブリックプレビュー板として提供されているMicrosoft Loopを使えるようにしていきたいと思…

pospome.work

pospomeのプログラミング日記

tech.naviplus.co.jp

古いMacを、アンティークの様に売買する。それは、リサイクル活動して、評価できます。しかしながら、そのアンティ…

maku77.github.io

ドキュメンテーションコメントとは Kotlin のソースコードにドキュメンテーションコメントを記述しておくと、関数のコメントなどから API ドキュメントを自動生成することができるようになります。 また、関数のドキュメンテーションコメントを記述しておけば、AndroidStudio などの開発環境上でコーディングしているときに、関数の説明をポップアップ表示してくれるようになります。 Java のドキュメンテーションコメントのフォーマットは Javadoc と呼ばれていますが、Kotlin のドキュメンテーションコメントは KDoc と呼びます。 KDoc - Documenting Kotlin Code 多人数で使用するライブラリを作成する場合は API ドキュメントを用意するのは必須です。 一人で開発する場合でも、API の仕様を明確にして実装する癖をつけることで、自然にきれいな設計を行う力が身に付きます。 ドキュメンテーションコメントに関する基本的な考え方は下記を参照してください。 ドキュメンテーションコメントの書き方 Javadoc コメントと KDoc コメントの違い KDoc ドキュメンテーションコメントは、Javadoc と同様に /** で始め */ で終わります。 @タグ名 の形で付加的な情報を記述できることも同様ですが、KDoc のみで使用できるタグや、逆に KDoc では使えないタグもあります（後述）。 Javadoc コメント内では HTML タグを使った修飾が可能でしたが、KDoc コメントでは代わりに Markdown を使用します。 下記は、Kotlin のドキュメントサイトで紹介されている KDoc コメントの記述例です。 /** * A group of *members*. * * This class has no useful logic; it's just a documentation example. * * @param T the type of a member in this group. * @property name the name of this group. * @constructor Creates an empty group. */ class Group(val name: String) { /** * Adds a [member] to this group. * @return the new size of the group. */ fun add(member: T): Int { ... } } KDoc ドキュメンテーションコメントの書き方 パラメータに関する記述 /** * Sums two values, [a] and [b]. */ fun myAdd(a: Int, b: Int) = a + b KDoc のドキュメンテーションコメントから関数のパラメータを参照するときは、上記のようにパラメータ名をブラケット [] で囲みます。

kumande-craft.com

当サイトに掲載されている広告について 当サイトでは、第三者配信の広告サービス（Googleアドセンス、A8.net、Am

gmgs.blog.jp

スウィート・ナッシングス(Sweet Nothings) / Chihana

yellowfin.co.jp

Yellowfin サポートセンターでは、コミュニティフォーラムやWiki、YouTubeビデオ（各種チュートリアル）などをご利用いただけます。ぜひご活用ください。