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

すべての行にコードの ..

2:デフォルトの名無しさん
22/08/05 08:50:43.38 PgkbhFj6.net
後で見てわかりやすいじゃん

3:デフォルトの名無しさん
22/08/05 10:52:16 46nM87up.net
これに慣れちゃうとコードを見ずにコメントだけを読む癖がついちゃうのよね。
んでコメントが適切に更新されてなかったり間違ってたりするとバクを見つけられないという逆効果。

4:デフォルトの名無しさん
22/08/05 12:24:26.70 Cl5esxPG.net
いやコード読めよw

5:デフォルトの名無しさん
22/08/05 12:31:44.75 PgkbhFj6.net
>>3
流石にそりゃねぇわw

6:デフォルトの名無しさん
22/08/05 16:45:08.49 5HRZknnA.net
>>3
そりゃバクなんて見つからんわな…
2chで細かい誤字に突っ込むのもヤボだがこの場合あんたの注意力の無さを物語ってないか？ｗ

7:デフォルトの名無しさん
22/08/05 18:57:54.58 0oLm+VFo.net
クソスレ立てるアホウ

8:デフォルトの名無しさん
22/08/05 20:57:12 MMyPerMm.net
そしてコードに変更が入ってもコメントはメンテナンスされず…

9:デフォルトの名無しさん
22/08/06 09:47:00 v5UPRIG+.net
途中から「…という処理を誰か書いといてください」になってる

10:デフォルトの名無しさん
22/08/06 17:57:49.35 fi6gTDde.net
>>3
コードとコメントが食い違ってて、解析に余計に時間がかかる場合はあるな
コードを修正したならコメントも修正してほしいわ
もし、時間がないならコメントを消してくれた方がまだいい

11:デフォルトの名無しさん
22/08/06 19:47:49.48 69IGV6Y3.net
i++; // iに1を足す
分かっとるがな(・o・)

12:デフォルトの名無しさん
22/08/06 21:54:22.13 Zy70ULhC.net
>>11
演算子オーバーロードを考慮したのでは？

13:デフォルトの名無しさん
22/08/07 09:26:54.07 7cQO/w5k.net
# こ
# ん
# に
# ち
# は

14:デフォルトの名無しさん
22/08/07 11:38:34.34 M7izT6UM.net
i++; // iに1を足してから
printf("%d",a[i]);　//値を印字
みたいに順番が大事な時があるだろ
無理に擁護するとｗ

15:デフォルトの名無しさん
22/08/07 12:15:09.75 7nPARvzT.net
>>14
そう書いてその順番に流れない言語って何がある？

16:デフォルトの名無しさん
22/08/07 14:41:16 r7YsBDkd.net
>>15
江頭2：50は予定通りに進んでくれないのでは。

17:デフォルトの名無しさん
22/08/07 17:13:32 C8Sscu1x.net
>>15
そういうことを言ってるんじゃなくて、
順番が大事なことを修正者に伝えるためのコメントのことを言ってるんだろ

18:デフォルトの名無しさん
22/08/07 18:33:39.34 Rb+FepPS.net
>>17
だからコメントで言語仕様を説明する必要はないってことだろ
つーか商品を使ってプログラミング教育するなよｗ
if (foo() && bar()) { // 順番が大事なのでfooとbarを入れ替えないこと
とか書いてたらアホやんｗ

19:デフォルトの名無しさん
22/08/07 19:18:06.65 C8Sscu1x.net
>>18
だから、そういう言語仕様の話ではなくて、
例えば自作の関数が二つあって、それらを呼び出す順番が決まっている場合、それをコメントに残す必要の話をしているのよ
「順番が大事」な処理なんてよくあるだろ？
で、それを知らずに修正して不具合を出すこともまたよくあるだろ？

20:デフォルトの名無しさん
22/08/07 19:22:42.30 r7YsBDkd.net
インクリメントされた数値が表示されるのか、される前の数値が表示されるのか。
これはユーザーにとって重要な仕様なので、コメントにきっちり書いておくべきです。
わかりきったことなどと言う奴は、この世にも要らない。

21:デフォルトの名無しさん
22/08/07 19:24:52.36 Rb+FepPS.net
>>19
> 例えば自作の関数が二つあって、それらを呼び出す順番が決まっている場合、それをコメントに残す必要の話をしているのよ
ないんじゃね？ｗ
処理の順番が重要なんて当たり前でしょ
知らないで順番変更する時点で素人
どういうコードで「これは処理の順番しても大丈夫だな」って
勘違いするっていうんだよｗ

22:デフォルトの名無しさん
22/08/07 19:26:37.77 Rb+FepPS.net
>>20
総合計の出力は、合計処理を実行してから
画面に出力してくださいとでも書くんか？ｗ

23:デフォルトの名無しさん
22/08/07 19:29:00.19 r7YsBDkd.net
>>22
ええそうです。
なぜなら、そのようなバグで私たちユーザーは長年苦しんできているからです。

24:デフォルトの名無しさん
22/08/07 20:57:09.74 Rb+FepPS.net
>>23
ユーザーが困ることと、詳細設計をソースコードにコメントで書くこになんの関係があんの？
ソースコードがあれば十分じゃない

25:デフォルトの名無しさん
22/08/07 20:58:30.80 r7YsBDkd.net
あなたのためのコーディングではなく、ユーザーのためのコーディングを心がけて下さい。

26:デフォルトの名無しさん
22/08/07 20:58:56.85 Rb+FepPS.net
ユーザーのためにコーディングでしょ？
コード書けばいいってことでしょｗ

27:デフォルトの名無しさん
22/08/07 22:37:39.37 njOvv5rZ.net
>>20
コードにきっちり書かれているから、同じことをコメントに書く必要はない。
コメントに書くとしたら、表示の前にインクリメントする理由を説明する。
例えばiを個数カウンタとして使っている場合、「iの初期値は0なので、
個数を表示する前にiをインクリメントする」と書く。

28:デフォルトの名無しさん
22/08/07 22:49:53.87 r7YsBDkd.net
いいえダメです。
その油断がユーザーを窮地に立たせるのです。

29:デフォルトの名無しさん
22/08/07 23:10:55.21 r7YsBDkd.net
// すべての行にコードの意味をコメントで書きませう！！

30:デフォルトの名無しさん
22/08/07 23:12:35.10 7cQO/w5k.net
コメントは　読み手に対する　思いやり

31:デフォルトの名無しさん
22/08/07 23:43:27.10 Zc4u6CYP.net
すべてのコード行にコメントを書いてあるものを見たことがないんだけど？

32:デフォルトの名無しさん
22/08/08 01:08:14.98 q8wrugIB.net
だってよ。
お前（ >>1 ）の妄想だ。

33:デフォルトの名無しさん
22/08/08 09:25:55.98 opl+vMMW.net
>>31-32
お前らが、みたことないだけだろ？
コメントもりだくさんな、コードレビュー済みのコードを見せてやるよ
URLﾘﾝｸ(shell-mag.com)

34:デフォルトの名無しさん
22/08/08 13:15:48 AVRRjrX2.net
>>33
ユニケージで察した

35:デフォルトの名無しさん
22/08/08 17:20:47.37 LPWK9yT9.net
>>18
それをアホというならお前がアホ
もしくは大規模なプログラムの開発経験がないのだろう
アホに見られるのが嫌ならプログラマなんてやらん方がいいぞ
もっとカッコいい職業があるだろ知らんけどｗ

36:デフォルトの名無しさん
22/08/08 18:36:44.09 sf8DoyKQ.net
>>33
これは素晴らしいな。
誰が見ても意図がわかる。
コメントはこうじゃないと。
ね、ライオンズ先生。

37:デフォルトの名無しさん
22/08/08 21:01:20.66 6Y7zkB4i.net
>>36
やってることはわかるが、意図はわからんなｗ
> 88 # 余分な文字列を削除
> 89 sed 's/BUMON_//g' |

38:デフォルトの名無しさん
22/08/08 21:13:02.08 RTOmNKV0.net
独自関数は大文字にして欲しい

39:デフォルトの名無しさん
22/08/09 08:53:49.33 CSOBwvJK.net
i++ //iに3を足す

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

41:デフォルトの名無しさん
22/08/09 19:47:53.41 DKHX4SbF.net
>>40
だから気まぐれでコメント書くな
コメント書く基準を言え
i++をi+1に書き換えたらだめな場合もあるからな
おまえは無駄なものまでぜーんぶ書いてろよ
毎回な

42:デフォルトの名無しさん
22/08/09 19:54:23.27 zBoBPKOv.net
>>39
間違ってるよ

43:デフォルトの名無しさん
22/08/09 19:57:00.44 oM0lzHLp.net
// すべての行にコードの意味をコメントで書きませう！！！

44:デフォルトの名無しさん
22/08/09 19:58:27.86 j5b5w5HH.net
>>33
それコードの説明をするのが目的のサンプルだろ？

45:デフォルトの名無しさん
22/08/09 19:59:41.27 oM0lzHLp.net
コード一行に対してコメント3行くらい書くのが本物のプロ。
コメント書かないのは素人のお遊び。

46:デフォルトの名無しさん
22/08/09 20:01:53.61 j5b5w5HH.net
>>33
それ何をしたいのか、何をやっているかのコメントがないな。

47:デフォルトの名無しさん
22/08/09 20:26:31.83 BuR95QZy.net
コードを読むには高い集中力が必要で、疲れるから
少しの集中力で読めるコメントというのは、コードリーディングを楽にする
と今思った。

48:デフォルトの名無しさん
22/08/09 21:23:53.55 8jqj7J8S.net
>>41
だから警告が必要なとこに書くのが基準だよ
そう書いてるだろ
気まぐれだったら全部の行には書かんだろが俺はしないけど
とにかくこんなことまでコメント書いてうっとおしいとかみっともないとか思う奴はプログラマに向いてないよ
人間はどんなミスをするかわからないからな
初心者は変数名や書き方を規則的にすることでわざわざコメントつけなくても説明になるだろと思うだろうが
それはあくまで理想論に過ぎない

49:デフォルトの名無しさん
22/08/09 22:15:26.73 j5b5w5HH.net
>>48
プログラミング言語としての意味を書くコメントは分けて考えなければいけない。

50:デフォルトの名無しさん
22/08/09 22:29:35.74 DKHX4SbF.net
>>48
だから警告が必要なところってどこだよ？
同じようなコードなのに、ここは警告が必要そうだから書いて
ここは警告が必要ないから書かないのか？
新人「ここ、何も書いてないから入れ替えて大丈夫っすね！」

51:デフォルトの名無しさん
22/08/09 23:12:39.45 oM0lzHLp.net
どこにどういうコメントを書くべきか。
それが経験であり熟練度。
一兵卒から始まり、経験を積み上げ、コメントを磨き上げ、天下の大将軍を目指す。

52:デフォルトの名無しさん
22/08/10 07:28:51.02 g2r8Vobb.net
>>50
警告は勘違いして読みがちな箇所に書くんだよ
例えば先のfoo barの呼び出し順を間違ったらバグる場合とかね
あと、マジックナンバーの説明とか

53:デフォルトの名無しさん
22/08/10 10:45:24.90 w8koR26R.net
>>52
だからhoge hageの呼び出し順を間違ってもバグらないときは書かないんだろ？
書いてない時、それが書き漏れなのか
そうでないのかどうやって判断すんの？

54:デフォルトの名無しさん
22/08/10 11:04:38.48 kxq3xLmV.net
>>53
勘違いして読みがちな箇所だよ
そうではない箇所には必要ない

55:デフォルトの名無しさん
22/08/10 11:09:58.92 4xqPHIM2.net
// 君かわいいね
// 今夜どうかな？

56:デフォルトの名無しさん
22/08/10 18:41:34.76 F9/ptNap.net
全ての行にコメントを書けって。
なぜ手抜きすることばかり考える。
全部の行に書け。

57:デフォルトの名無しさん
22/08/10 18:43:33.00 w8koR26R.net
はいはい。精神論、体育会系、自分の頭で何も考えない能無しｗ

58:デフォルトの名無しさん
22/08/10 18:48:44.05 F9/ptNap.net
コードよりコメントのほうが少なかったら、職業プログラマとして恥だと思え。
そんなもんはアマチュアだ。

59:デフォルトの名無しさん
22/08/10 18:52:46.10 w8koR26R.net
>>58
ならそのプロのコードとやらを見せて
あ、ユニケージはいらんからｗ

60:デフォルトの名無しさん
22/08/10 19:32:04.66 sfYj45Aw.net
>>58
Linuxのコードを見てから言え

61:デフォルトの名無しさん
22/08/10 19:54:36.97 kx7L/9BB.net
なんでキチの相手するかなぁ...

62:デフォルトの名無しさん
22/08/11 00:42:43.49 ZCQSRwpp.net
品質は良いです。
2022令和最新版。

63:デフォルトの名無しさん
22/08/11 20:03:54.11 COAKBVTr.net
昔MSXのBASICでコメント文で書かれた機械語のコードを呼び出すというテクニックがあったな
プロテクトメモリ？何それ！

64:デフォルトの名無しさん
22/08/12 05:02:07.55 gexMmBrM.net
DATA文やろ
コメントってなんやｗ

65:デフォルトの名無しさん
22/08/12 10:06:50.34 rNj9X+5C.net
アレって投稿用に完成したアセンブラをBASICに変換していただけで
人力でDATA文から作っていたやつがいたらすごいよな
読者は人力だが……

66:デフォルトの名無しさん
22/08/12 15:07:27.81 1wYgfbYo.net
>>65
いや、当時は普通にハンドアセンブルしてたよ。
主要命令はZ80ヘキサを暗記してたし、未だにいくつか覚えてるわ。

67:デフォルトの名無しさん
22/08/13 20:53:20.18 h4E07yCU.net
>>64
DATAじゃなくてシングルクォートのREM文に機械語のコードをゴリゴリ埋め込んでおいて
BASICプログラムが格納されるアドレスが毎回同じなことを利用して、REM文のアドレスにいきなり制御を渡すのよ
そういう変態プログラムのシューティングゲームが月刊ASCIIかなんかに載ってて驚愕した記憶がある
実際の処理は読んでないからそのREM文がすべて直接実行可能な機械語コードだったのか、先頭部分を呼び出し後にBASE64変換みたいなことをしてたのかは知らないけどw

68:デフォルトの名無しさん
22/08/20 13:01:32.12 Z0uFASkB.net
フレームワークから出力しただけのコードにコメントつける作業してるだけで自分で書いてないんじゃね
これがＩＴ人材とかいうんだから笑える

69:デフォルトの名無しさん
22/08/21 02:26:06.18 03eMfefm.net
>>68
フレームワークの意味がわかってないな

70:デフォルトの名無しさん
[ここ壊れてます] .net
KEИTAωωω

71:デフォルトの名無しさん
[ここ壊れてます] .net
>>66
だよね
JR系は重宝した

72:デフォルトの名無しさん
22/08/21 14:17:15.02 TydpFBMU.net
>>69
最近のフレームワークはコード丸ごと出力するんですよおじいちゃん

73:デフォルトの名無しさん
22/08/21 16:04:33.11 S3KIc3UD.net
とてつもなく読み難いがこんな内容がまだあるな
URLﾘﾝｸ(archive.org)

74:デフォルトの名無しさん
22/08/21 16:05:57.69 S3KIc3UD.net
ごめんこっちで普通に読めたわ
URLﾘﾝｸ(archive.org)

75:デフォルトの名無しさん
[ここ壊れてます] .net
>>72
その最近のフレームワークとやらを教えてくれw

76:デフォルトの名無しさん
[ここ壊れてます] .net
フレームワークがコードを出力するのか
凄い時代だな

77:デフォルトの名無しさん
22/08/21 22:34:42.27 0v7G3Tlr.net
frame、workという英語の意味もわからないんだろうな。

78:デフォルトの名無しさん
22/08/22 00:50:50.41 8/FESXuX.net
普通に10年くらい前からあると思うが
化石って悲惨だな

79:デフォルトの名無しさん
22/08/22 00:56:22.11 t08mT3YP.net
scaffoldの事じゃね？
ひな形が出力されるようなフレームワークは割とあるかも

80:デフォルトの名無しさん
22/08/22 01:14:00.53 8/FESXuX.net
どう時代を読んでもRoRが流行った以降はそれがフレームワークの機能としてのスタンダード
こんな何いってるかわからん化石の相手したくねえわ

81:デフォルトの名無しさん
22/08/22 04:50:29.27 XjbJEJN/.net
フレームワークのフレームワークのコードが自動的に出ると言っているのか？
それならフレームワークのコードを入力していた方がおかしい。
毎回、打ち直す阿呆はなんなんだろうな。

82:デフォルトの名無しさん
22/08/22 11:52:26.30 9riQaK8D.net
今は有料のAI が、ソースコードを提案する
もぐらストア
github copilotでrailsのコードを書いてみた
www.youtube.com/watch?v=ZMi1BsConT4

83:デフォルトの名無しさん
22/08/22 12:03:35.44 9riQaK8D.net
例えば、Ruby on Rails で、scaffold・足場を作ると、
タスクランナーで自動的に数十のファイルが作られて、そのままCRUD 操作ができる
データベースにも登録できる
たいていの香具師は、神のようなscaffoldに驚く。
データベースも含めて、最初からアプリが動くから

84:デフォルトの名無しさん
22/08/22 12:13:07.87 9riQaK8D.net
20年ぐらい前、Rails がscaffold で革命を起こした。
たった数分で、最初からアプリが動く。
だから猫も杓子も、Railsで開発した
ハーバード大学でも、Railsを教えていた
君らは、年収3千万円のサラリーマンになりたくないだろ？
起業して、1千億円ぐらい儲けたいだろ？
それなら、Railsを使え

85:デフォルトの名無しさん
22/08/22 23:36:35.59 tDcpQn+Z.net
なぜそれ以後のフレームワークは
プログラムを書くようになったんだろうね?
設定だけ書けば
プログラムを自動生成するようにしなかったのはなぜ?

86:デフォルトの名無しさん
22/08/23 02:36:33.95 SpzGkw08.net
>>85
そういうのは今度は設定がたいへんなことになる。

87:デフォルトの名無しさん
22/08/23 06:43:34.39 B9nWN5M8.net
>>85
痒いところを掻きたいからだろ

88:デフォルトの名無しさん
22/08/29 13:36:18.34 PCOEcac8.net
//ここで個数分足しておく
//この会社だけはやめておけ
for(int i=0;i<count;i++)
こういうコメントなら見たことある
後任に大切なメッセージを残してくれるいい人もいたもんだ

89:デフォルトの名無しさん
22/08/29 14:39:38.43 LzHDSE21.net
うそくせ

90:デフォルトの名無しさん
22/08/29 18:20:29.96 WqXG6rq1.net
>>88
コーエーのゲームでクソゲーとデータに残していた事件も知らないのか？

91:デフォルトの名無しさん
22/08/29 18:57:23.20 vUI7JH1g.net
ROMにおまんこしてぇって描かれてた件

92:デフォルトの名無しさん
22/08/29 18:58:14.70 8Zx7GLWP.net
クソゲーツマランと漢字4文字で思いっきり埋め込まれてたやつなw

93:デフォルトの名無しさん
22/08/29 21:12:36.64 VjHWIo6X.net
それコメントか？

94:デフォルトの名無しさん
[ここ壊れてます] .net
暗号。

95:デフォルトの名無しさん
22/08/30 00:27:28.20 9oJv0wUh.net
「空は青かった」

96:デフォルトの名無しさん
22/08/30 00:38:34.26 aovba9nj.net
>>95
スレチ

97:デフォルトの名無しさん
22/08/30 23:05:58.50 F66FctjD.net
イースターエッグの類？

98:デフォルトの名無しさん
22/08/31 01:49:24.48 vP2ngpvh.net
コメント大事

99:デフォルトの名無しさん
22/08/31 02:22:21.19 QjUlXYzC.net
//ここで個数分足しておく
//それは青かった
for(int i=0;i<count;i++)
結構シュールだな

100:デフォルトの名無しさん
22/09/03 19:14:44.05 wh+RxvHk.net
//ここで愛を足しておく
//それは僕が青かった
for(int i=0;i<count;i++)
結構シュールだな

101:デフォルトの名無しさん
22/09/04 02:54:22.42 DITh+Llf.net
「空が青かった」は
朝鮮人が北朝鮮に帰るときに手紙が検閲されるから
理不尽な目に合えば一見中立に見える「空は青かった」と外向けの手紙に書いた
一種の暗号
どの手紙にも書いてあったという
この文脈だと「いい天気が続いています」とか
さらにぼかすのかな?
要するにここには来るなという意味

102:デフォルトの名無しさん
22/09/08 13:31:13.13 E2yDW5TJ.net
プログラムコードとコメントの齟齬が出てきて、
やがてコメントのメンテナンスが放棄される。
自分でコメントを無視した修正に慣れている内に、やがて異動。
後任者が「コメントが充実してて親切やん！」と喜んでいたというが、
そのプロジェクトは次のバージョンで火を吹いた。
火消しに俺まで駆り出され、自分の過去に書いたコメントだけが頼りだったが、
火に油を注ぐ結果となり、更なる火消し要員を集めるハメに。。。
炎上に次ぐ炎上の果てに、プロジェクトは空中分解という形で無事終了。
プロジェクト反省会という人民裁判が開かれたが、運良くコロナに罹って過労死は免れた。
聞くところによると、スケープゴート(誰でもいいから1匹必要)が一人、
精神を壊して退職したらしい。

103:デフォルトの名無しさん
22/10/12 05:45:37.83 xaa83KyA.net
大昔に、Intelが公開したアセンブリ言語のソースがまさにそんな感じで
高級言語の時代にも、そうした文化の名残りがあるのかも知れませんね

104:デフォルトの名無しさん
22/10/12 06:45:43.26 RAZWVaSn.net
>>100
//ここで愛を足しておく（友達は勇気だけじゃない）
//それは僕が青かった（ネズミに耳をかじれれた）
作者分かっちゃった！

105:デフォルトの名無しさん
22/11/28 06:18:26.62 FppqmMkh.net
ドキュメントとして書けよ