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

■ このスレッドは過去ログ倉庫に格納されています
1デフォルトの名無しさん
垢版 |
2022/08/05(金) 08:48:41.94ID:tBb6kaMd
自分で書いた命令の意味が理解できないのかな?
英語苦手?ふーん。だからローマ字使ってるのねw
2022/08/05(金) 08:50:43.38ID:PgkbhFj6
後で見てわかりやすいじゃん
2022/08/05(金) 10:52:16.44ID:46nM87up
これに慣れちゃうとコードを見ずにコメントだけを読む癖がついちゃうのよね。
んでコメントが適切に更新されてなかったり間違ってたりするとバクを見つけられないという逆効果。
4デフォルトの名無しさん
垢版 |
2022/08/05(金) 12:24:26.70ID:Cl5esxPG
いやコード読めよw
2022/08/05(金) 12:31:44.75ID:PgkbhFj6
>>3
流石にそりゃねぇわw
2022/08/05(金) 16:45:08.49ID:5HRZknnA
>>3
そりゃバクなんて見つからんわな…
2chで細かい誤字に突っ込むのもヤボだがこの場合あんたの注意力の無さを物語ってないか?w
2022/08/05(金) 18:57:54.58ID:0oLm+VFo
クソスレ立てるアホウ
2022/08/05(金) 20:57:12.25ID:MMyPerMm
そしてコードに変更が入ってもコメントはメンテナンスされず…
2022/08/06(土) 09:47:00.16ID:v5UPRIG+
途中から「…という処理を誰か書いといてください」になってる
10デフォルトの名無しさん
垢版 |
2022/08/06(土) 17:57:49.35ID:fi6gTDde
>>3
コードとコメントが食い違ってて、解析に余計に時間がかかる場合はあるな

コードを修正したならコメントも修正してほしいわ
もし、時間がないならコメントを消してくれた方がまだいい
2022/08/06(土) 19:47:49.48ID:69IGV6Y3
i++; // iに1を足す

分かっとるがな(・o・)
12デフォルトの名無しさん
垢版 |
2022/08/06(土) 21:54:22.13ID:Zy70ULhC
>>11
演算子オーバーロードを考慮したのでは?
2022/08/07(日) 09:26:54.07ID:7cQO/w5k
# こ
# ん
# に
# ち
# は
2022/08/07(日) 11:38:34.34ID:M7izT6UM
i++; // iに1を足してから
printf("%d",a[i]); //値を印字

みたいに順番が大事な時があるだろ
無理に擁護するとw
15デフォルトの名無しさん
垢版 |
2022/08/07(日) 12:15:09.75ID:7nPARvzT
>>14
そう書いてその順番に流れない言語って何がある?
16デフォルトの名無しさん
垢版 |
2022/08/07(日) 14:41:16.79ID:r7YsBDkd
>>15
江頭2:50は予定通りに進んでくれないのでは。
17デフォルトの名無しさん
垢版 |
2022/08/07(日) 17:13:32.22ID:C8Sscu1x
>>15
そういうことを言ってるんじゃなくて、
順番が大事なことを修正者に伝えるためのコメントのことを言ってるんだろ
2022/08/07(日) 18:33:39.34ID:Rb+FepPS
>>17
だからコメントで言語仕様を説明する必要はないってことだろ
つーか商品を使ってプログラミング教育するなよw

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

とか書いてたらアホやんw
19デフォルトの名無しさん
垢版 |
2022/08/07(日) 19:18:06.65ID:C8Sscu1x
>>18
だから、そういう言語仕様の話ではなくて、
例えば自作の関数が二つあって、それらを呼び出す順番が決まっている場合、それをコメントに残す必要の話をしているのよ

「順番が大事」な処理なんてよくあるだろ?
で、それを知らずに修正して不具合を出すこともまたよくあるだろ?
20デフォルトの名無しさん
垢版 |
2022/08/07(日) 19:22:42.30ID:r7YsBDkd
インクリメントされた数値が表示されるのか、される前の数値が表示されるのか。
これはユーザーにとって重要な仕様なので、コメントにきっちり書いておくべきです。
わかりきったことなどと言う奴は、この世にも要らない。
21デフォルトの名無しさん
垢版 |
2022/08/07(日) 19:24:52.36ID:Rb+FepPS
>>19
> 例えば自作の関数が二つあって、それらを呼び出す順番が決まっている場合、それをコメントに残す必要の話をしているのよ
ないんじゃね?w

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

どういうコードで「これは処理の順番しても大丈夫だな」って
勘違いするっていうんだよw
22デフォルトの名無しさん
垢版 |
2022/08/07(日) 19:26:37.77ID:Rb+FepPS
>>20
総合計の出力は、合計処理を実行してから
画面に出力してくださいとでも書くんか?w
23デフォルトの名無しさん
垢版 |
2022/08/07(日) 19:29:00.19ID:r7YsBDkd
>>22
ええそうです。
なぜなら、そのようなバグで私たちユーザーは長年苦しんできているからです。
24デフォルトの名無しさん
垢版 |
2022/08/07(日) 20:57:09.74ID:Rb+FepPS
>>23
ユーザーが困ることと、詳細設計をソースコードにコメントで書くこになんの関係があんの?
ソースコードがあれば十分じゃない
25デフォルトの名無しさん
垢版 |
2022/08/07(日) 20:58:30.80ID:r7YsBDkd
あなたのためのコーディングではなく、ユーザーのためのコーディングを心がけて下さい。
26デフォルトの名無しさん
垢版 |
2022/08/07(日) 20:58:56.85ID:Rb+FepPS
ユーザーのためにコーディングでしょ?
コード書けばいいってことでしょw
27デフォルトの名無しさん
垢版 |
2022/08/07(日) 22:37:39.37ID:njOvv5rZ
>>20
コードにきっちり書かれているから、同じことをコメントに書く必要はない。
コメントに書くとしたら、表示の前にインクリメントする理由を説明する。
例えばiを個数カウンタとして使っている場合、「iの初期値は0なので、
個数を表示する前にiをインクリメントする」と書く。
28デフォルトの名無しさん
垢版 |
2022/08/07(日) 22:49:53.87ID:r7YsBDkd
いいえダメです。
その油断がユーザーを窮地に立たせるのです。
29デフォルトの名無しさん
垢版 |
2022/08/07(日) 23:10:55.21ID:r7YsBDkd
// すべての行にコードの意味をコメントで書きませう!!
2022/08/07(日) 23:12:35.10ID:7cQO/w5k
コメントは 読み手に対する 思いやり
31デフォルトの名無しさん
垢版 |
2022/08/07(日) 23:43:27.10ID:Zc4u6CYP
すべてのコード行にコメントを書いてあるものを見たことがないんだけど?
32デフォルトの名無しさん
垢版 |
2022/08/08(月) 01:08:14.98ID:q8wrugIB
だってよ。
お前( >>1 )の妄想だ。
33デフォルトの名無しさん
垢版 |
2022/08/08(月) 09:25:55.98ID:opl+vMMW
>>31-32

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

コメントもりだくさんな、コードレビュー済みのコードを見せてやるよ
https://shell-mag.com/newcodereview-57/
2022/08/08(月) 13:15:48.22ID:AVRRjrX2
>>33
ユニケージで察した
2022/08/08(月) 17:20:47.37ID:LPWK9yT9
>>18
それをアホというならお前がアホ
もしくは大規模なプログラムの開発経験がないのだろう

アホに見られるのが嫌ならプログラマなんてやらん方がいいぞ
もっとカッコいい職業があるだろ知らんけどw
36デフォルトの名無しさん
垢版 |
2022/08/08(月) 18:36:44.09ID:sf8DoyKQ
>>33
これは素晴らしいな。
誰が見ても意図がわかる。
コメントはこうじゃないと。
ね、ライオンズ先生。
2022/08/08(月) 21:01:20.66ID:6Y7zkB4i
>>36
やってることはわかるが、意図はわからんなw

> 88 # 余分な文字列を削除
> 89 sed 's/BUMON_//g' |
38デフォルトの名無しさん
垢版 |
2022/08/08(月) 21:13:02.08ID:RTOmNKV0
独自関数は大文字にして欲しい
2022/08/09(火) 08:53:49.33ID:CSOBwvJK
i++ //iに3を足す
2022/08/09(火) 19:25:43.92ID:blRATQyo
>>18
例えば途中から入って来た奴があるいは半年後の自分が
あこれbar()を先に呼んだほうが高速化できるんじゃないか?とか書き換えてテストしてバグってしまう前に
あらかじめ書いておいたほうが親切だし無駄な時間を消費せずに済む
41デフォルトの名無しさん
垢版 |
2022/08/09(火) 19:47:53.41ID:DKHX4SbF
>>40
だから気まぐれでコメント書くな

コメント書く基準を言え
i++をi+1に書き換えたらだめな場合もあるからな
おまえは無駄なものまでぜーんぶ書いてろよ
毎回な
2022/08/09(火) 19:54:23.27ID:zBoBPKOv
>>39
間違ってるよ
43デフォルトの名無しさん
垢版 |
2022/08/09(火) 19:57:00.44ID:oM0lzHLp
// すべての行にコードの意味をコメントで書きませう!!!
44デフォルトの名無しさん
垢版 |
2022/08/09(火) 19:58:27.86ID:j5b5w5HH
>>33
それコードの説明をするのが目的のサンプルだろ?
45デフォルトの名無しさん
垢版 |
2022/08/09(火) 19:59:41.27ID:oM0lzHLp
コード一行に対してコメント3行くらい書くのが本物のプロ。
コメント書かないのは素人のお遊び。
46デフォルトの名無しさん
垢版 |
2022/08/09(火) 20:01:53.61ID:j5b5w5HH
>>33
それ何をしたいのか、何をやっているかのコメントがないな。
2022/08/09(火) 20:26:31.83ID:BuR95QZy
コードを読むには高い集中力が必要で、疲れるから
少しの集中力で読めるコメントというのは、コードリーディングを楽にする

と今思った。
2022/08/09(火) 21:23:53.55ID:8jqj7J8S
>>41
だから警告が必要なとこに書くのが基準だよ
そう書いてるだろ

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

とにかくこんなことまでコメント書いてうっとおしいとかみっともないとか思う奴はプログラマに向いてないよ
人間はどんなミスをするかわからないからな
初心者は変数名や書き方を規則的にすることでわざわざコメントつけなくても説明になるだろと思うだろうが
それはあくまで理想論に過ぎない
49デフォルトの名無しさん
垢版 |
2022/08/09(火) 22:15:26.73ID:j5b5w5HH
>>48
プログラミング言語としての意味を書くコメントは分けて考えなければいけない。
2022/08/09(火) 22:29:35.74ID:DKHX4SbF
>>48
だから警告が必要なところってどこだよ?

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

新人「ここ、何も書いてないから入れ替えて大丈夫っすね!」
51デフォルトの名無しさん
垢版 |
2022/08/09(火) 23:12:39.45ID:oM0lzHLp
どこにどういうコメントを書くべきか。
それが経験であり熟練度。
一兵卒から始まり、経験を積み上げ、コメントを磨き上げ、天下の大将軍を目指す。
52デフォルトの名無しさん
垢版 |
2022/08/10(水) 07:28:51.02ID:g2r8Vobb
>>50
警告は勘違いして読みがちな箇所に書くんだよ
例えば先のfoo barの呼び出し順を間違ったらバグる場合とかね
あと、マジックナンバーの説明とか
53デフォルトの名無しさん
垢版 |
2022/08/10(水) 10:45:24.90ID:w8koR26R
>>52
だからhoge hageの呼び出し順を間違ってもバグらないときは書かないんだろ?

書いてない時、それが書き漏れなのか
そうでないのかどうやって判断すんの?
54デフォルトの名無しさん
垢版 |
2022/08/10(水) 11:04:38.48ID:kxq3xLmV
>>53
勘違いして読みがちな箇所だよ
そうではない箇所には必要ない
2022/08/10(水) 11:09:58.92ID:4xqPHIM2
// 君かわいいね
// 今夜どうかな?
56デフォルトの名無しさん
垢版 |
2022/08/10(水) 18:41:34.76ID:F9/ptNap
全ての行にコメントを書けって。
なぜ手抜きすることばかり考える。
全部の行に書け。
2022/08/10(水) 18:43:33.00ID:w8koR26R
はいはい。精神論、体育会系、自分の頭で何も考えない能無しw
58デフォルトの名無しさん
垢版 |
2022/08/10(水) 18:48:44.05ID:F9/ptNap
コードよりコメントのほうが少なかったら、職業プログラマとして恥だと思え。
そんなもんはアマチュアだ。
2022/08/10(水) 18:52:46.10ID:w8koR26R
>>58
ならそのプロのコードとやらを見せて
あ、ユニケージはいらんからw
2022/08/10(水) 19:32:04.66ID:sfYj45Aw
>>58
Linuxのコードを見てから言え
2022/08/10(水) 19:54:36.97ID:kx7L/9BB
なんでキチの相手するかなぁ...
62デフォルトの名無しさん
垢版 |
2022/08/11(木) 00:42:43.49ID:ZCQSRwpp
品質は良いです。
2022令和最新版。
2022/08/11(木) 20:03:54.11ID:COAKBVTr
昔MSXのBASICでコメント文で書かれた機械語のコードを呼び出すというテクニックがあったな
プロテクトメモリ?何それ!
2022/08/12(金) 05:02:07.55ID:gexMmBrM
DATA文やろ
コメントってなんやw
65デフォルトの名無しさん
垢版 |
2022/08/12(金) 10:06:50.34ID:rNj9X+5C
アレって投稿用に完成したアセンブラをBASICに変換していただけで
人力でDATA文から作っていたやつがいたらすごいよな
読者は人力だが……
2022/08/12(金) 15:07:27.81ID:1wYgfbYo
>>65
いや、当時は普通にハンドアセンブルしてたよ。
主要命令はZ80ヘキサを暗記してたし、未だにいくつか覚えてるわ。
2022/08/13(土) 20:53:20.18ID:h4E07yCU
>>64
DATAじゃなくてシングルクォートのREM文に機械語のコードをゴリゴリ埋め込んでおいて
BASICプログラムが格納されるアドレスが毎回同じなことを利用して、REM文のアドレスにいきなり制御を渡すのよ
そういう変態プログラムのシューティングゲームが月刊ASCIIかなんかに載ってて驚愕した記憶がある
実際の処理は読んでないからそのREM文がすべて直接実行可能な機械語コードだったのか、先頭部分を呼び出し後にBASE64変換みたいなことをしてたのかは知らないけどw
2022/08/20(土) 13:01:32.12ID:Z0uFASkB
フレームワークから出力しただけのコードにコメントつける作業してるだけで自分で書いてないんじゃね
これがIT人材とかいうんだから笑える
69デフォルトの名無しさん
垢版 |
2022/08/21(日) 02:26:06.18ID:03eMfefm
>>68
フレームワークの意味がわかってないな
2022/08/21(日) 12:53:57.94ID:j3ukytx2
KEИTAωωω
71デフォルトの名無しさん
垢版 |
2022/08/21(日) 12:54:58.55ID:j3ukytx2
>>66
だよね
JR系は重宝した
2022/08/21(日) 14:17:15.02ID:TydpFBMU
>>69
最近のフレームワークはコード丸ごと出力するんですよおじいちゃん
2022/08/21(日) 16:04:33.11ID:S3KIc3UD
とてつもなく読み難いがこんな内容がまだあるな
https://archive.org/stream/19880611_MSXDOS_asembler/MSX-DOS%E3%82%A2%E3%82%BB%E3%83%B3%E3%83%96%E3%83%A9%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0_djvu.txt
74デフォルトの名無しさん
垢版 |
2022/08/21(日) 16:05:57.69ID:S3KIc3UD
ごめんこっちで普通に読めたわ
https://archive.org/details/19880611_MSXDOS_asembler
2022/08/21(日) 17:37:58.17ID:3JIuIXQv
>>72
その最近のフレームワークとやらを教えてくれw
2022/08/21(日) 17:49:20.61ID:aagQnukO
フレームワークがコードを出力するのか
凄い時代だな
77デフォルトの名無しさん
垢版 |
2022/08/21(日) 22:34:42.27ID:0v7G3Tlr
frame、workという英語の意味もわからないんだろうな。
2022/08/22(月) 00:50:50.41ID:8/FESXuX
普通に10年くらい前からあると思うが
化石って悲惨だな
2022/08/22(月) 00:56:22.11ID:t08mT3YP
scaffoldの事じゃね?
ひな形が出力されるようなフレームワークは割とあるかも
2022/08/22(月) 01:14:00.53ID:8/FESXuX
どう時代を読んでもRoRが流行った以降はそれがフレームワークの機能としてのスタンダード
こんな何いってるかわからん化石の相手したくねえわ
81デフォルトの名無しさん
垢版 |
2022/08/22(月) 04:50:29.27ID:XjbJEJN/
フレームワークのフレームワークのコードが自動的に出ると言っているのか?

それならフレームワークのコードを入力していた方がおかしい。
毎回、打ち直す阿呆はなんなんだろうな。
2022/08/22(月) 11:52:26.30ID:9riQaK8D
今は有料のAI が、ソースコードを提案する

もぐらストア

github copilotでrailsのコードを書いてみた
www.youtube.com/watch?v=ZMi1BsConT4
2022/08/22(月) 12:03:35.44ID:9riQaK8D
例えば、Ruby on Rails で、scaffold・足場を作ると、
タスクランナーで自動的に数十のファイルが作られて、そのままCRUD 操作ができる

データベースにも登録できる

たいていの香具師は、神のようなscaffoldに驚く。
データベースも含めて、最初からアプリが動くから
2022/08/22(月) 12:13:07.87ID:9riQaK8D
20年ぐらい前、Rails がscaffold で革命を起こした。
たった数分で、最初からアプリが動く。
だから猫も杓子も、Railsで開発した

ハーバード大学でも、Railsを教えていた

君らは、年収3千万円のサラリーマンになりたくないだろ?
起業して、1千億円ぐらい儲けたいだろ?

それなら、Railsを使え
2022/08/22(月) 23:36:35.59ID:tDcpQn+Z
なぜそれ以後のフレームワークは
プログラムを書くようになったんだろうね?
設定だけ書けば
プログラムを自動生成するようにしなかったのはなぜ?
86デフォルトの名無しさん
垢版 |
2022/08/23(火) 02:36:33.95ID:SpzGkw08
>>85
そういうのは今度は設定がたいへんなことになる。
87デフォルトの名無しさん
垢版 |
2022/08/23(火) 06:43:34.39ID:B9nWN5M8
>>85
痒いところを掻きたいからだろ
2022/08/29(月) 13:36:18.34ID:PCOEcac8
//ここで個数分足しておく
//この会社だけはやめておけ
for(int i=0;i<count;i++)

こういうコメントなら見たことある
後任に大切なメッセージを残してくれるいい人もいたもんだ
2022/08/29(月) 14:39:38.43ID:LzHDSE21
うそくせ
90デフォルトの名無しさん
垢版 |
2022/08/29(月) 18:20:29.96ID:WqXG6rq1
>>88
コーエーのゲームでクソゲーとデータに残していた事件も知らないのか?
91デフォルトの名無しさん
垢版 |
2022/08/29(月) 18:57:23.20ID:vUI7JH1g
ROMにおまんこしてぇって描かれてた件
2022/08/29(月) 18:58:14.70ID:8Zx7GLWP
クソゲーツマランと漢字4文字で思いっきり埋め込まれてたやつなw
2022/08/29(月) 21:12:36.64ID:VjHWIo6X
それコメントか?
94デフォルトの名無しさん
垢版 |
2022/08/29(月) 21:40:05.11ID:iMDvJogZ
暗号。
2022/08/30(火) 00:27:28.20ID:9oJv0wUh
「空は青かった」
2022/08/30(火) 00:38:34.26ID:aovba9nj
>>95
スレチ
97デフォルトの名無しさん
垢版 |
2022/08/30(火) 23:05:58.50ID:F66FctjD
イースターエッグの類?
2022/08/31(水) 01:49:24.48ID:vP2ngpvh
コメント大事
2022/08/31(水) 02:22:21.19ID:QjUlXYzC
//ここで個数分足しておく
//それは青かった
for(int i=0;i<count;i++)

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

結構シュールだな
2022/09/04(日) 02:54:22.42ID:DITh+Llf
「空が青かった」は
朝鮮人が北朝鮮に帰るときに手紙が検閲されるから
理不尽な目に合えば一見中立に見える「空は青かった」と外向けの手紙に書いた
一種の暗号
どの手紙にも書いてあったという
この文脈だと「いい天気が続いています」とか
さらにぼかすのかな?
要するにここには来るなという意味
2022/09/08(木) 13:31:13.13ID:E2yDW5TJ
プログラムコードとコメントの齟齬が出てきて、
やがてコメントのメンテナンスが放棄される。
自分でコメントを無視した修正に慣れている内に、やがて異動。
後任者が「コメントが充実してて親切やん!」と喜んでいたというが、
そのプロジェクトは次のバージョンで火を吹いた。
火消しに俺まで駆り出され、自分の過去に書いたコメントだけが頼りだったが、
火に油を注ぐ結果となり、更なる火消し要員を集めるハメに。。。
炎上に次ぐ炎上の果てに、プロジェクトは空中分解という形で無事終了。
プロジェクト反省会という人民裁判が開かれたが、運良くコロナに罹って過労死は免れた。
聞くところによると、スケープゴート(誰でもいいから1匹必要)が一人、
精神を壊して退職したらしい。
2022/10/12(水) 05:45:37.83ID:xaa83KyA
大昔に、Intelが公開したアセンブリ言語のソースがまさにそんな感じで
高級言語の時代にも、そうした文化の名残りがあるのかも知れませんね
2022/10/12(水) 06:45:43.26ID:RAZWVaSn
>>100

//ここで愛を足しておく(友達は勇気だけじゃない)
//それは僕が青かった(ネズミに耳をかじれれた)

作者分かっちゃった!
2022/11/28(月) 06:18:26.62ID:FppqmMkh
ドキュメントとして書けよ
■ このスレッドは過去ログ倉庫に格納されています
5ちゃんねるの広告が気に入らない場合は、こちらをクリックしてください。

ニューススポーツなんでも実況