NAL-6295 https://blog.hatena.ne.jp/NAL-6295/ NAL-6295の舌先三寸 https://nal-6295.hatenadiary.org/ IT雑感 コメントとはソースコードに挿入する事ができる注釈みたいなものである。 注釈とは「本文中の語句に解説を付ける事。」である。 つまり、わかりにくい、伝わりにくいところにだけコメントを記述する必要がある。必要以上に多すぎてはいけない。 読めばわかるようなコードにコメントを付けてはいけないという事。 コードと同じ意味をコメントで記述する事にも意味を持たない。 それは注釈ではない翻訳だ。まぁそれでも、関数ヘッダくらいは良いかなとも思う。 説明文書の自動生成くらいには使える。 でも、ソースを読むにあたっては、あまり役に立つとは言えない。 それでも、関数内に無駄に多いコメントよりは良いだろう。関数内にむやみ… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fnal-6295.hatenadiary.org%2Fentry%2F20050614%2F1118760803" title="コメントは注釈 - NAL-6295の舌先三寸" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> Hatena Blog https://hatena.blog 2005-06-14 23:53:23 rich https://nal-6295.hatenadiary.org/entry/20050614/1118760803 1.0 100%