コメント研究すれ。

**デフォルトの名無しさん** · 2008/03/20(木) 04:03:47

Ｃ言語でコメントを書く時とても迷うよな？

・見易さ
・書き易さ
・分かり易さ
・一貫性（統一性）
・とどけこの思い

とか、何でもいいからいい感じのコメントの書き方を考えませう。

**デフォルトの名無しさん** · 2012/05/20(日) 12:56:33.42

俺が今までに見た最強のコメント。

a=1; //aに1を代入

**デフォルトの名無しさん** · 2012/05/20(日) 13:05:57.02

>>77
そういうのはコメント書け書けとうるさい奴に対する嫌がらせでわざとやってるんだろう
もしそうじゃなかったら、そいつは即刻クビ/留年にすべきだ

忍法帖【Lv=28,xxxPT】 · 2012/05/20(日) 13:15:25.70

>>76
if文で判定していることそのものを指すときには疑問文にすることはしばしば。例えば、
--
if (fp == NULL) { // ファイルは開けなかった?
--
こんな感じ。
>76の例は変数名が不適切だからそれを補う意味ではありではないかな。

**デフォルトの名無しさん** · 2012/05/21(月) 16:26:15.33

>>76
怒るとこ違うんじゃないの？
俺だったらif (status)とかいう意味不明な変数名じゃなくてif (connected)とかにしろと言うな。

**デフォルトの名無しさん** · 2012/05/21(月) 16:28:00.41

>>76
どう考えても{}内は接続完了のときの処理だろ。
{}内が接続完了出来なかったときの処理なら怒る。

**デフォルトの名無しさん** · 2012/05/21(月) 20:59:28.19

＞{}内が接続完了出来なかったときの処理なら怒る

実際あるから困るw
何かエラーが発生したら0以外のエラーコード返すようなの

**デフォルトの名無しさん** · 2012/06/26(火) 13:59:59.23

/**//**************
コメント内容
*******************/
関数宣言

最近はこんな感じの書き方してる。
最後のスラッシュ削れば後ろに書いた関数がまとめてコメントアウト出来る

**デフォルトの名無しさん** · 2012/06/26(火) 15:22:02.65

これは、イライラするな

**デフォルトの名無しさん** · 2012/06/26(火) 22:52:24.63

＞/**//**************

半端な所にある // も含むの？

**デフォルトの名無しさん** · 2012/06/27(水) 01:48:12.98

キモすぎ

**デフォルトの名無しさん** · 2012/06/29(金) 00:56:48.87

/**//*************
******************/←これを外すと
func(){ }
　　↓ここまでコメントアウトして止まる
/**//*************

**デフォルトの名無しさん** · 2012/06/29(金) 01:04:56.31

/******************
コメント内容
*******************
関数1

/******************
コメント内容
*******************/ ← 結局ここで止まるから//無くても同じじゃね？
関数2

**デフォルトの名無しさん** · 2012/06/29(金) 02:05:50.80

吊ってくるノシ

**デフォルトの名無しさん** · 2012/06/29(金) 11:17:26.13

コメントが真であるためには、コメントに責任を持たせればよい。
http://nojiriko.asia/prolog/prolog_55.html
の中に現れる、資料/2という述語定義とそれを呼び出す副目標は
意味的にコメントである。
こうして置けば、コメントが書き換わっただけだと、プログラムの実行が
偽になってしまう。

**デフォルトの名無しさん** · 2012/07/01(日) 11:31:23.60

//*
最初の/の有無でほげほげ
//*/

**デフォルトの名無しさん** · 2012/07/17(火) 21:58:11.02

適度に遊びを入れて______s----------z______みたいな区切りって使えないかな
やっぱ怒られる？

**デフォルトの名無しさん** · 2012/08/05(日) 22:01:00.08

コメントには処理の目的を書いて欲しい

// 高さを取得する
じゃなくて

// カーソルの有効判定をするために高さを取得する
ってな感じ

**デフォルトの名無しさん** · 2012/08/06(月) 17:41:36.58

>>93
それ、「カーソルの有効判定をする」メソッドにして、「高さを取得する」のコメント無しの方がいいよ。

**デフォルトの名無しさん** · 2012/08/09(木) 19:21:44.98

// おまじない
// メイン関数
// 変数定義
// for ループ
// 代入
// プリント関数
// ゼロをリターン

**デフォルトの名無しさん** · 2012/08/30(木) 10:34:05.48

>>90
こっちの方がいいんじゃないか
http://nojiriko.asia/prolog/bsort_2.html

**デフォルトの名無しさん** · 2012/10/06(土) 13:58:04.07

>>79
if文が条件判断なのは明らかだからコメントを疑問形にする意味がないと思う

**デフォルトの名無しさん** · 2012/10/14(日) 17:22:57.65

コードで書いていることを
コメントにするな。

**デフォルトの名無しさん** · 2012/10/14(日) 17:47:55.40

>>98
解説してはいけないの？

**デフォルトの名無しさん** · 2012/10/14(日) 17:55:11.33

>>99
if(isXXX()) {} //比較命令です。isXXX関数を呼び出して値が真であるかチェックしています。

みたいなのはいらんよ。
コードに書いてあることなんだから。

**１０１** · 2012/10/16(火) 12:58:44.71

このスレッドは１００を超えました。
もう書けないので、新しいスレッドを立ててくださいです。。。

停止 · 2012/10/16(火) 14:58:19.22

糞・スレッドストッパー。。。(￣ー￣)ﾆﾔﾘｯ

**デフォルトの名無しさん** · 2012/10/16(火) 22:34:35.48

上から読んでも下から読んでも全く同じ回文プログラム

main(){printf("死ねハゲ");}//};)"ゲハね死"(tnirp{)(niam

**デフォルトの名無しさん** · 2012/10/16(火) 23:56:11.71

バイト並び違うな。

**デフォルトの名無しさん** · 2012/10/17(水) 10:06:24.43

それ末尾に//挟んで逆さまにしただけやん

**デフォルトの名無しさん** · 2012/10/19(金) 23:33:46.51

コメントすれだけに//は外せない

**デフォルトの名無しさん** · 2012/10/20(土) 19:46:38.20

>>105
おお、任意のプログラムを回文プログラムにするアルゴリズム！

**デフォルトの名無しさん** · 2012/11/19(月) 02:21:58.00

ドキシジェンだっけ？
コメントで判定して自動でドキュメント作ってくれる奴
アレの書き方を習得してみたいが資料がよく分からん

**デフォルトの名無しさん** · 2012/11/19(月) 03:50:54.79

>>108
取り敢えず、Doxygenスレに行ってみてはどうだろう。

**デフォルトの名無しさん** · 2012/11/20(火) 02:02:57.81

専用スレがあるのかｗ

**デフォルトの名無しさん** · 2012/11/22(木) 08:43:19.46

Prologだとコメントに引数を与えると述語になる。

**デフォルトの名無しさん** · 2012/11/23(金) 05:17:16.32

引数を与えるとではなくて、末尾にピリオドを付加すれば、だ。
全角文字の扱いからSWI-Prologでは「、」「。」など、ひらがな、カタカナの
記号を含む場合は、全体をシングルクォートで囲む必要がある。
IF/Prologではその必要はない。それから本当に頭の % を削るかどうかを思案する。

**デフォルトの名無しさん** · 2013/03/01(金) 22:28:19.61

>>64
ああｗそれよく見るけどよくムカつくｗ

**デフォルトの名無しさん** · 2013/03/04(月) 21:49:47.37

専ブラ使ってない人まだいたのか

**デフォルトの名無しさん** · 2013/04/06(土) 15:03:59.14

*/

/*

**デフォルトの名無しさん** · 2013/05/23(木) 00:50:14.75

**デフォルトの名無しさん** · 2013/05/23(木) 07:53:37.56

　　　/*
　　/
　/
*/

**デフォルトの名無しさん** · 2013/06/19(水) 22:15:18.37

コメントがどこに対してかかっているのかを明確にするために、

//コメント
if(){

}

ではなく、

if()
{ //コメント

}

と書くようにした。
前者だと、コメントアウトがごちゃごちゃしてるコードを修正するときなんかに、
if節の前の部分の処理や宣言に対するコメントなのか、if節の処理に対するコメントなのかわかりづらい。

関数宣言も

void foo()
//コメント
{

}

って書くようにしてる。
インデントをIDEがサポートしてくれないからめんどくさいけど、グローバル変数やexternや、関数外の注釈とかと
まぎらわしくなくなる。

**デフォルトの名無しさん** · 2013/06/20(木) 01:11:47.24

>>118
んな独自手法編み出さして使わなくても、コメントは対象の前、コメントの前とコメント対象の後に
空行を置くようにすれば自然で十分。

**デフォルトの名無しさん** · 2013/06/20(木) 02:08:57.09

関数宣言のあとにコメントってのはなんか落ち着かないなぁ

**デフォルトの名無しさん** · 2013/06/20(木) 03:04:23.85

>>118
全コード1から自分で書くんならそれでいいんだろうけどな。

**デフォルトの名無しさん** · 2013/06/20(木) 03:13:59.06

ブロック開始で一行開けるのがなんとなく気持ち悪いし、
関数のブロック前に何か書くのはK&R時代みたいでもっと気持ち悪い。
こんなん好みの問題だけどなんてーかなぁ…

**デフォルトの名無しさん** · 2013/06/21(金) 09:13:39.54

コメントを書かないことで解決

コードがすべてを説明してくれるさ（　･`ω･´）ｷﾘｯ

**デフォルトの名無しさん** · 2013/07/20(土) NY:AN:NY.AN

ノーコメント

**デフォルトの名無しさん** · 2013/07/22(月) NY:AN:NY.AN

// そして我々はこの世界から旅立つことを決めたのだ

**デフォルトの名無しさん** · 2013/08/31(土) NY:AN:NY.AN

>>120
func1();//ここでは△□している
func2();//ここでは○×している
こういう場合だけ後付けありだと思う。

**デフォルトの名無しさん** · 2013/09/04(水) 02:16:40.74

未来の自分へのメッセージはちょっとめんどくさいけど
過去の自分からのメッセージはちょっと嬉しい
記憶力が足りない人のささやかな楽しみそれがコメント

**デフォルトの名無しさん** · 2013/11/24(日) 21:09:23.13

/*****************************************************/
/* コメントを箱型にするのマジでやめてぇ */
/* 一体何の利点があるのさ */
/* 誰か教えろください */
/*****************************************************/

**デフォルトの名無しさん** · 2013/11/25(月) 09:41:55.61

ｦﾀの自己満足でっす
こんなコメント見た事ある

//初期化処理
2chかよ

**デフォルトの名無しさん** · 2013/11/25(月) 10:02:08.63

>>128
他人を枠に嵌めることに生き甲斐を見出したがる人に、喜ばれます。

**デフォルトの名無しさん** · 2013/12/25(水) 18:36:16.64

>>128
それ区切り見たいでかわいいからやってたんだけど何でダメなの？

**デフォルトの名無しさん** · 2013/12/25(水) 22:08:22.83

コメントとは忘却という自然の摂理に対するささやかな抵抗である
ただし、そのコメントが現時点でも適切であるとは限らないが・・・

**デフォルトの名無しさん** · 2013/12/25(水) 23:26:17.20

>>131
/*****************************************************/
/* こんな風には左寄せなら別にいいのよ。 */
/* 若干煩いけど保守するの問題ないし。 */
/*****************************************************/

/*****************************************************/
/* それをこんな風に箱型にするなって話。　　　　　　　　　　　　*/
/* コメントを書き換えるときにいちいち空白の調整するコストがバカらしい。 */
/*****************************************************/

/*
　*--------------------------------------------------------
　* こんな風に、一行ずつ閉じない方法もあり。
　*--------------------------------------------------------
　*/

/********************************************************
* こんな風に、囲う方法もあり。
********************************************************/

**デフォルトの名無しさん** · 2013/12/26(木) 00:14:16.31

というか、
/*

*/
これで十分。javadoc形式のときは
/**
*
*/
を使うが。

**デフォルトの名無しさん** · 2013/12/26(木) 00:32:48.55

>>130,133
まず間違いなく個人の不文律なので、同じソースを一人でずーっと保守し続けるという前提が
置けない限り統一が困難。がんばって統一してもルールを決めた本人以外全員が「俺のと違う」
という小さなストレスを感じ続けることになる。元の担当者が居なくなったりするともう誰もうれしくない。

右を閉じるとさらにウザさが際立つ件は >133 の言うとおり。

**デフォルトの名無しさん** · 2013/12/26(木) 20:08:18.83

>>128
これエディタのマクロで箱型枠管理とかしてたんかね？

手作業で管理しつづけてたなら、ある意味尊敬する。

**デフォルトの名無しさん** · 2013/12/26(木) 20:34:04.16

昔は手作業で管理するなんて本質的じゃないところに無駄に手間を掛ける奇習もあったからねぇ。
酷いプロジェクトだと、修正履歴にコメント修正なんて書いてあって該当の修正履歴No.見ると箱型の修正だったり。

**デフォルトの名無しさん** · 2013/12/26(木) 21:32:34.84

>>137
「ソースの桁揃え」コミットよりも酷いけど「コメントを箱型に修正」コミットとかやられるよりはマシ。

**デフォルトの名無しさん** · 2013/12/26(木) 22:48:46.16

>>128
箱型コメがかっこよく見える人がいるらしい。
俺はまだその境地に達していないようだ。

**デフォルトの名無しさん** · 2013/12/26(木) 23:15:20.71

かっこいいというか「見やすい」んだよ
原稿用紙が「見やすい」とされるのと同じ程度の理屈
そういうふうになっていないコメントは「未完成のまま放置されている」のだから、「完成させる」は立派な修正

理屈はきちんと聞いて拾いあげてあげないといかん
だから君の業務プログラマーとしての技術はいつまでたっても

**デフォルトの名無しさん** · 2013/12/27(金) 00:50:11.31

>>140
囲みが無いとコメントが見づらいソースって、あれだろ、どんな処理にも一行ごとに
ぺたぺたコメントが入ってて、さらにひどいときにはそれが全部空行で区切られてるやつ。
説明用のサンプルソースからコピペしてきました、みたいな。

健全なソースなら適切な構造化が前提だし、コメントも前に空行一個置く程度で十分目立つ。

**デフォルトの名無しさん** · 2013/12/27(金) 01:28:31.60

「（うわー右揃えるのかったりー・・・。）」

「（･･･誰も見てない、右の */ 消すなら今のうち！！）」

**デフォルトの名無しさん** · 2013/12/27(金) 08:08:42.69

>>140
>理屈はきちんと聞いて拾いあげてあげないといかん
「俺の考え方と違う！きめえ！俺のほうが正しい！」って一人でブツブツ言って延々再修正してるだけだからな
コミュ障かよ

**デフォルトの名無しさん** · 2013/12/27(金) 14:36:55.33

フォントが等幅じゃない場合があるしなー。
一応フォントが等幅を謳っていたとしても、強調表示とかでズレるエディタもあるし。

**デフォルトの名無しさん** · 2014/01/13(月) 12:20:07.15

コメントはソースの意味を少しだけ忘れた頃に書くのがよい。なにやってんだこいつという第三者の視点で書ける。
そうやっていくうちに第三者の視点（客観性）が身につく

**デフォルトの名無しさん** · 2014/01/14(火) 02:33:51.16

俺はコード書いて3秒で忘れるので

**デフォルトの名無しさん** · 2014/03/29(土) 22:27:22.36

それ、コメント書きながら忘れるじゃん

**デフォルトの名無しさん** · 2014/03/29(土) 23:22:25.32

略
"<th valign=\"top\">sendmailのパス</th><td><strong>[ NG ]</strong>たぶん
<input value=\"${sendmails[$cnt]}\" /> です。たぶんね。たぶんだから。
サーバ指定であればそれが正解です。和田の言うことはどうせ当てになりませんから。
すいませんねほんと。</td>";

略
push @result,"<th valign=\"top\">sendmailのパス</th><td><strong>[ NG ]</strong>
ごめん・・・。和田も頑張ったんだけどさ・・・。そう人生うまくいくもんじゃないよね・・・。
探したよ！必死に！交差点でも夢の中でもこんなとこにいるはずもないのに・・・。
ということで、ホントごめん・・・。サーバ会社の人に聞いてみてください・・・。
生まれてきてごめんなさい・・・。</td>";
}
◆出典
//www.synck.com/contents/download/cgi-perl/mailformpro.html#spec
mailformpro4.1.2/mailformpro/librarys/check/main.cgi

**デフォルトの名無しさん** · 2014/03/29(土) 23:33:20.00

# Comments:
# i read an interesting article many years ago about the effects of
　　drugs on spiders in National Geographic Magazine. %0A
　　it showed webs woven by spiders ""under the influence.""
　　spiders high on marijuana wove bad webs;
　　spiders on LSD wove exceptionally geometrical webs.%0
　　Aanyone know how i can locate the date of and
　　issue this appeared in?%0A %0Amany thanks in advance to someone
　　who has walked at least a mile in my shoes.

**デフォルトの名無しさん** · 2014/03/30(日) 00:16:27.97

何年か前に興味深い本を読んだんだ。
ドラッグが蜘蛛に及ぼす影響ってやつをナショナルジェオグラフィックマガジンで。

それには蜘蛛が”ラリった”状態でどんなふうに巣を張るのかが書いてあったんだ。
大麻でラリった蜘蛛は最悪な巣だった。
LSDでラリった蜘蛛はとても幾何学的な巣を作っていた。
だれか予言できるか？このプログラムが問題を起こす日付けを。
あ　そうそう　こんな長いこと素足で長く歩かせてくれただれかさんに有難うって
言っとかなくちゃあなぁ。

◆出典
//search.cpan.org/~softdia/Tie-Eudora-0.01/lib/Tie/Eudora.pm

**デフォルトの名無しさん** · 2014/03/31(月) 05:23:20.27

どうすればコメントのないコードを書くことができるか、というようなテーマの本は
結構出ているものだろうか。

**デフォルトの名無しさん** · 2014/04/08(火) 01:36:05.04

>>151
アセンブリからさらにわかりやすくした高水準言語は
十分に人間が読めるのでコメントなどいらないという思想だな。高水準言語至上主義。
アスペはコード読むよりコメント読むほうが苦痛だというがほんとかねｗ
まあいくらプログラミング言語の表現力がましても
やはり一般人には自然言語のほうがわかりやすいと思うわ

英語をベースにしたコメント言語を作るとかは？

**デフォルトの名無しさん** · 2014/04/08(火) 10:36:53.78

>>152
読み手がどうとかいうよりさきにコメンドの内容によるだろ
無意味だったり間違ってたり関係無かったりするコメント読むよりはコード読むほうが楽だろJK

**デフォルトの名無しさん** · 2014/11/09(日) 04:12:05.56

ソースコードのところどころに無関係なコメントを忍ばせるのが俺流。
// 今日は帰りに焼きそばを買って帰る
とか書いてる。

**デフォルトの名無しさん** · 2014/11/09(日) 06:53:10.50

コメントは見出しみたいな物だ。何をしてるのか１行で自然言語で書かれていればソースコードのみより
明らかに読みやすい。

**デフォルトの名無しさん** · 2014/11/09(日) 09:44:07.78

>>155
実際それが目的なんだけどな
コピペが放置されてたり、そもそもコメントが無かったりで
「毎行コメント書くべし」なんてルールが出来て、
こんなコメントが量産される訳だ

i++;　//ループカウンタをインクリメント

**デフォルトの名無しさん** · 2014/11/09(日) 09:50:25.62

某でかいとこの案件で、毎行コメント書けって言われて
無能しかいねーんだなと思ったな。

**デフォルトの名無しさん** · 2014/11/09(日) 10:02:14.16

まあ、デカいとこになるとさ、エンジニアではない有象無象のオペレータ向けの
ルールにせざるを得なくなるから仕方ないのかな～とは思うけど、
やっかいなのはこういうデカイとこ特有のくだらないルールを見て
何でも右習えでドヤ顔で小規模チームにも適用したがるアホなマネージャ連中だ

出来る人向けのルールとしては、GoogleのC++のが結構参考になる、かな？
あそこは例外禁止だけど

**デフォルトの名無しさん** · 2014/11/09(日) 10:05:41.82

以前に毎行コメント書けなんて言うデカいところのコードレビューで、
「構造体は代入出来ないからmemcpyで書き直せ」なんて言われちったよ

レビュアーがこういうレベルだから変なルールを作らないといけないのか
変なルールで固めて考えさせないから、こういうレベルに育ってしまうのかね…

**デフォルトの名無しさん** · 2014/11/24(月) 01:07:35.04

/* テスト　*/

**デフォルトの名無しさん** · 2015/02/28(土) 08:46:56.17

エレメンタルプログラミングのすゝめ
ttp://takeshik.org/blog/2015/02/28/elemental-programming/

**デフォルトの名無しさん** · 2015/03/28(土) 18:43:37.83

>>161
けっこう面白い

**デフォルトの名無しさん** · 2015/09/25(金) 08:17:05.49

>>156
何のカウンタなんだよw

**デフォルトの名無しさん** · 2016/01/27(水) 20:50:32.13

コードをそのまま言葉にしただけのコメントは可読性を下げるだけだな。

**デフォルトの名無しさん** · 2016/10/08(土) 08:50:39.94

コメントって難しい

**デフォルトの名無しさん** · 2016/10/10(月) 14:22:13.01

>>164 コードをそのまま言葉にしただけのコメントは可読性を下げるだけだな。
激しく同意する。

コメントは概要を知らせるもの。詳細についてはソースを見ればよい。ソース全部を見
渡す前に迅速にそのコードの概要を知らしめるコメントであるべき。

**デフォルトの名無しさん** · 2016/11/02(水) 08:53:02.08

>>156
ひどいルールだな