すべての行にコードの意味をコメントで書くアホウ

**デフォルトの名無しさん** · 2022/08/05(金) 08:48:41.94

自分で書いた命令の意味が理解できないのかな？
英語苦手？ふーん。だからローマ字使ってるのねｗ

**デフォルトの名無しさん** · 2022/08/05(金) 08:50:43.38

後で見てわかりやすいじゃん

**デフォルトの名無しさん** · 2022/08/05(金) 10:52:16.44

これに慣れちゃうとコードを見ずにコメントだけを読む癖がついちゃうのよね。
んでコメントが適切に更新されてなかったり間違ってたりするとバクを見つけられないという逆効果。

**デフォルトの名無しさん** · 2022/08/05(金) 12:24:26.70

いやコード読めよw

**デフォルトの名無しさん** · 2022/08/05(金) 12:31:44.75

>>3
流石にそりゃねぇわw

**デフォルトの名無しさん** · 2022/08/05(金) 16:45:08.49

>>3
そりゃバクなんて見つからんわな…
2chで細かい誤字に突っ込むのもヤボだがこの場合あんたの注意力の無さを物語ってないか？ｗ

**デフォルトの名無しさん** · 2022/08/05(金) 18:57:54.58

クソスレ立てるアホウ

**デフォルトの名無しさん** · 2022/08/05(金) 20:57:12.25

そしてコードに変更が入ってもコメントはメンテナンスされず…

**デフォルトの名無しさん** · 2022/08/06(土) 09:47:00.16

途中から「…という処理を誰か書いといてください」になってる

**デフォルトの名無しさん** · 2022/08/06(土) 17:57:49.35

>>3
コードとコメントが食い違ってて、解析に余計に時間がかかる場合はあるな

コードを修正したならコメントも修正してほしいわ
もし、時間がないならコメントを消してくれた方がまだいい

**デフォルトの名無しさん** · 2022/08/06(土) 19:47:49.48

i++; // iに1を足す

分かっとるがな(・o・)

**デフォルトの名無しさん** · 2022/08/06(土) 21:54:22.13

>>11
演算子オーバーロードを考慮したのでは？

**デフォルトの名無しさん** · 2022/08/07(日) 09:26:54.07

# こ
# ん
# に
# ち
# は

**デフォルトの名無しさん** · 2022/08/07(日) 11:38:34.34

i++; // iに1を足してから
printf("%d",a[i]);　//値を印字

みたいに順番が大事な時があるだろ
無理に擁護するとｗ

**デフォルトの名無しさん** · 2022/08/07(日) 12:15:09.75

>>14
そう書いてその順番に流れない言語って何がある？

**デフォルトの名無しさん** · 2022/08/07(日) 14:41:16.79

>>15
江頭2：50は予定通りに進んでくれないのでは。

**デフォルトの名無しさん** · 2022/08/07(日) 17:13:32.22

>>15
そういうことを言ってるんじゃなくて、
順番が大事なことを修正者に伝えるためのコメントのことを言ってるんだろ

**デフォルトの名無しさん** · 2022/08/07(日) 18:33:39.34

>>17
だからコメントで言語仕様を説明する必要はないってことだろ
つーか商品を使ってプログラミング教育するなよｗ

if (foo() && bar()) { // 順番が大事なのでfooとbarを入れ替えないこと

とか書いてたらアホやんｗ

**デフォルトの名無しさん** · 2022/08/07(日) 19:18:06.65

>>18
だから、そういう言語仕様の話ではなくて、
例えば自作の関数が二つあって、それらを呼び出す順番が決まっている場合、それをコメントに残す必要の話をしているのよ

「順番が大事」な処理なんてよくあるだろ？
で、それを知らずに修正して不具合を出すこともまたよくあるだろ？

**デフォルトの名無しさん** · 2022/08/07(日) 19:22:42.30

インクリメントされた数値が表示されるのか、される前の数値が表示されるのか。
これはユーザーにとって重要な仕様なので、コメントにきっちり書いておくべきです。
わかりきったことなどと言う奴は、この世にも要らない。

**デフォルトの名無しさん** · 2022/08/07(日) 19:24:52.36

>>19
> 例えば自作の関数が二つあって、それらを呼び出す順番が決まっている場合、それをコメントに残す必要の話をしているのよ
ないんじゃね？ｗ

処理の順番が重要なんて当たり前でしょ
知らないで順番変更する時点で素人

どういうコードで「これは処理の順番しても大丈夫だな」って
勘違いするっていうんだよｗ

**デフォルトの名無しさん** · 2022/08/07(日) 19:26:37.77

>>20
総合計の出力は、合計処理を実行してから
画面に出力してくださいとでも書くんか？ｗ

**デフォルトの名無しさん** · 2022/08/07(日) 19:29:00.19

>>22
ええそうです。
なぜなら、そのようなバグで私たちユーザーは長年苦しんできているからです。

**デフォルトの名無しさん** · 2022/08/07(日) 20:57:09.74

>>23
ユーザーが困ることと、詳細設計をソースコードにコメントで書くこになんの関係があんの？
ソースコードがあれば十分じゃない

**デフォルトの名無しさん** · 2022/08/07(日) 20:58:30.80

あなたのためのコーディングではなく、ユーザーのためのコーディングを心がけて下さい。

**デフォルトの名無しさん** · 2022/08/07(日) 20:58:56.85

ユーザーのためにコーディングでしょ？
コード書けばいいってことでしょｗ

**デフォルトの名無しさん** · 2022/08/07(日) 22:37:39.37

>>20
コードにきっちり書かれているから、同じことをコメントに書く必要はない。
コメントに書くとしたら、表示の前にインクリメントする理由を説明する。
例えばiを個数カウンタとして使っている場合、「iの初期値は0なので、
個数を表示する前にiをインクリメントする」と書く。

**デフォルトの名無しさん** · 2022/08/07(日) 22:49:53.87

いいえダメです。
その油断がユーザーを窮地に立たせるのです。

**デフォルトの名無しさん** · 2022/08/07(日) 23:10:55.21

// すべての行にコードの意味をコメントで書きませう！！

**デフォルトの名無しさん** · 2022/08/07(日) 23:12:35.10

コメントは　読み手に対する　思いやり

**デフォルトの名無しさん** · 2022/08/07(日) 23:43:27.10

すべてのコード行にコメントを書いてあるものを見たことがないんだけど？

**デフォルトの名無しさん** · 2022/08/08(月) 01:08:14.98

だってよ。
お前（ >>1 ）の妄想だ。

**デフォルトの名無しさん** · 2022/08/08(月) 09:25:55.98

>>31-32

お前らが、みたことないだけだろ？

コメントもりだくさんな、コードレビュー済みのコードを見せてやるよ
https://shell-mag.com/newcodereview-57/

**デフォルトの名無しさん** · 2022/08/08(月) 13:15:48.22

>>33
ユニケージで察した

**デフォルトの名無しさん** · 2022/08/08(月) 17:20:47.37

>>18
それをアホというならお前がアホ
もしくは大規模なプログラムの開発経験がないのだろう

アホに見られるのが嫌ならプログラマなんてやらん方がいいぞ
もっとカッコいい職業があるだろ知らんけどｗ

**デフォルトの名無しさん** · 2022/08/08(月) 18:36:44.09

>>33
これは素晴らしいな。
誰が見ても意図がわかる。
コメントはこうじゃないと。
ね、ライオンズ先生。

**デフォルトの名無しさん** · 2022/08/08(月) 21:01:20.66

>>36
やってることはわかるが、意図はわからんなｗ

> 88 # 余分な文字列を削除
> 89 sed 's/BUMON_//g' |

**デフォルトの名無しさん** · 2022/08/08(月) 21:13:02.08

独自関数は大文字にして欲しい

**デフォルトの名無しさん** · 2022/08/09(火) 08:53:49.33

i++ //iに3を足す

**デフォルトの名無しさん** · 2022/08/09(火) 19:25:43.92

>>18
例えば途中から入って来た奴があるいは半年後の自分が
あこれbar()を先に呼んだほうが高速化できるんじゃないか？とか書き換えてテストしてバグってしまう前に
あらかじめ書いておいたほうが親切だし無駄な時間を消費せずに済む

**デフォルトの名無しさん** · 2022/08/09(火) 19:47:53.41

>>40
だから気まぐれでコメント書くな

コメント書く基準を言え
i++をi+1に書き換えたらだめな場合もあるからな
おまえは無駄なものまでぜーんぶ書いてろよ
毎回な

**デフォルトの名無しさん** · 2022/08/09(火) 19:54:23.27

>>39
間違ってるよ

**デフォルトの名無しさん** · 2022/08/09(火) 19:57:00.44

// すべての行にコードの意味をコメントで書きませう！！！

**デフォルトの名無しさん** · 2022/08/09(火) 19:58:27.86

>>33
それコードの説明をするのが目的のサンプルだろ？

**デフォルトの名無しさん** · 2022/08/09(火) 19:59:41.27

コード一行に対してコメント3行くらい書くのが本物のプロ。
コメント書かないのは素人のお遊び。

**デフォルトの名無しさん** · 2022/08/09(火) 20:01:53.61

>>33
それ何をしたいのか、何をやっているかのコメントがないな。

**デフォルトの名無しさん** · 2022/08/09(火) 20:26:31.83

コードを読むには高い集中力が必要で、疲れるから
少しの集中力で読めるコメントというのは、コードリーディングを楽にする

と今思った。

**デフォルトの名無しさん** · 2022/08/09(火) 21:23:53.55

>>41
だから警告が必要なとこに書くのが基準だよ
そう書いてるだろ

気まぐれだったら全部の行には書かんだろが俺はしないけど

とにかくこんなことまでコメント書いてうっとおしいとかみっともないとか思う奴はプログラマに向いてないよ
人間はどんなミスをするかわからないからな
初心者は変数名や書き方を規則的にすることでわざわざコメントつけなくても説明になるだろと思うだろうが
それはあくまで理想論に過ぎない

**デフォルトの名無しさん** · 2022/08/09(火) 22:15:26.73

>>48
プログラミング言語としての意味を書くコメントは分けて考えなければいけない。

**デフォルトの名無しさん** · 2022/08/09(火) 22:29:35.74

>>48
だから警告が必要なところってどこだよ？

同じようなコードなのに、ここは警告が必要そうだから書いて
ここは警告が必要ないから書かないのか？

新人「ここ、何も書いてないから入れ替えて大丈夫っすね！」

**デフォルトの名無しさん** · 2022/08/09(火) 23:12:39.45

どこにどういうコメントを書くべきか。
それが経験であり熟練度。
一兵卒から始まり、経験を積み上げ、コメントを磨き上げ、天下の大将軍を目指す。

**デフォルトの名無しさん** · 2022/08/10(水) 07:28:51.02

>>50
警告は勘違いして読みがちな箇所に書くんだよ
例えば先のfoo barの呼び出し順を間違ったらバグる場合とかね
あと、マジックナンバーの説明とか

**デフォルトの名無しさん** · 2022/08/10(水) 10:45:24.90

>>52
だからhoge hageの呼び出し順を間違ってもバグらないときは書かないんだろ？

書いてない時、それが書き漏れなのか
そうでないのかどうやって判断すんの？

**デフォルトの名無しさん** · 2022/08/10(水) 11:04:38.48

>>53
勘違いして読みがちな箇所だよ
そうではない箇所には必要ない