自作CGIを評価するスレ (672ﾚｽ)
上下前次1-新
313: 385 ◆T98LkrO.aM 03/06/04 12:52 ID:??? AAS
別にコメント書かないとかいう変なこだわりがあるわけじゃなくて、
ただ、自分はコメントなくてもすぐ分かるので人に見せる予定がないものに
コメント書かなくてもいいかなと..今は勉強中ということですし。
ただ、今回は見てもらおうとここに載せたわけなので、
モジュールの方にもコメントを書くべきだったと思いました..すみません。
314: 285 ◆T98LkrO.aM 03/06/04 12:54 ID:??? AAS
うお、385じゃなくて、285でした。
315(1): 03/06/04 13:20 ID:??? AAS
「未来の自分は他人です」という言葉を贈っておこう。
316(3): 298 03/06/04 14:07 ID:??? AAS
コメント無しでもいいような
わかりやすいクラス名、変数名、関数名をつけるのが基本です。
コメントが無いとわからないってのは
それだけ汚いソースだということです。
317: 285 ◆T98LkrO.aM 03/06/04 14:59 ID:??? AAS
>>315 >>316なるほど.
自分は今、就職希望の会社からCのソース(50-500行,10枚くらい)を渡されて、
この説明を書いてこいとか言われているのですが、コメントなくても
関数名, 変数名が分かりやすいし、うまい具合にサブルーチンに分けてあるので
コメント少ないですが、かなり読みやすいと思いました。
まあ、漏れのはコメントないと読みにくいかもしれませんが..
自分で見ても読みにくいな、と思ったらコメントでカバーするようにしてみます。
318(1): 301 03/06/04 19:23 ID:??? AAS
>>316
# ■■■ 俺の意見 ■■■
俺は、とにかくコメント入れるのに賛成派。
ルーチンの名前とか、変数の名前に意味を持たすのは当たり前だけど、
コメントあれば、コメントだけ読めば、何の処理してるのかわかるし。
# ■■■ ブロック毎にコメントを入れる ■■■
ブレスで囲って無くても、処理の単体が生まれる。
それ毎に、コメントを入れておけば、一行のコメント読めば数行理解できる。
# ■■■ ルーチンの使い方のコメントは重要！ ■■■
とくに、ルーチンの使い方のコメント。
省10
319: 301 03/06/04 19:40 ID:??? AAS
そうそう、掲示板の書き込みでも、
結構その人のセンスが出る。
変な所で改行してる人や、
長文なのに空白行入れず、
だらだらとメリハリの無い書き込みする人とか。
そういう人って、プログラムも汚いんだよね・・・
320: 285 ◆T98LkrO.aM 03/06/04 20:33 ID:??? AAS
はい、たしかに後で読む人がいるとすれば、
コメントは書いたほうがいいですね。
読む側と見るとありがたいものなので、自分でも書くようにします。
コメントが無いために間違った認識を受けたり、
重要な処理を 「これいらねぇんじゃね？」
とか思われて消されること減るはずだし。
321(1): 316 03/06/04 21:21 ID:??? AAS
>>318さん
自分が言いたいのは
「コメントを書くな」
ではなく
「コメントが無くてもわかるようなキレイな設計を心がけよう」
ってことです。
コメント関係ならプログラム技術板のこっちのスレのほうがいいかも。
2chｽﾚ:tech
322: 301 03/06/04 22:35 ID:??? AAS
>>321
スレタイにﾜﾗﾀ
いや、もう終わってるっぽいスレなので、
もういいかな〜っと。
とにかく、コメントは思うように入れまくってみたら良いと思う。
そうしてる内に、どういう風にコメント書いたら分かりやすいとか、
こういうコメントは無駄だとか、分かってくるだろうし。
前に、冗談だろうけど・・・
$hoge++; #1を増加
省8
323: 03/06/05 04:44 ID:??? AAS
OO なコード書いて POD 埋め込むようになってから
普通のコメントがかなり減った。スクリプトとドキュメント
同時に作るのは効率いいしオススメ。
324(1): 03/06/05 06:18 ID:t1krGQgT(1) AAS
外部ﾘﾝｸ:marugo.s15.xrea.com
掲示板のCGIです。
言語はPerl
325: 03/06/05 12:01 ID:??? AAS
>>324
>>280
326(1): 03/06/09 21:44 ID:JSBfbdyK(1) AAS
外部ﾘﾝｸ[zip]:do.sakura.ne.jp
むかしいじってたやつ、もう要らないから使えると思った香具師
勝手に使ってくれ。コメント皆無だけどね。
でも最後に軽く評価を聞きたいけどな。
327: 03/06/09 21:59 ID:??? AAS
>>326
あぁ。今見直したら俺が書いたやつじゃないものが入っていた・・・
Text::WordIteratorとか。。。
あーあ。まぁ、いいや。
328: 大塚裕司 03/06/09 23:17 ID:4isQpEIX(1) AAS
外部ﾘﾝｸ:elife.fam.cx
329(2): 211 [３０２５] 03/06/12 02:44 ID:??? AAS
ども。
いつぞやのコメント削除スクリプト作った俺です。
今作ってるスクリプトが行き詰まりました。
ちょっとイライラしたので、
息抜きにコメント削除スクリプトのバージョンアップとかしてみました。
このバージョンで、サブディレクトリ内も検索可能になりました。
深さは、どんなに深いサブディレクトリでも処理可能です。
外部ﾘﾝｸ[zip]:isweb25.infoseek.co.jp
・・・リファクタリングが必要かもしれん・・・
330: _ 03/06/12 03:03 ID:??? AAS
外部ﾘﾝｸ[html]:homepage.mac.com
331(1): 03/06/12 06:40 ID:??? AAS
>>329
＞深さは、どんなに深いサブディレクトリでも処理可能です。
当方にはそのスタックをあふれさせる準備があるが良いのか？
332(1): 211 [３０２５] 03/06/12 06:59 ID:??? AAS
>>331
う〜ん。
スタックを溢れさせる準備があるって意味がわからんです・・・。
とにかく、かなり深いディレクトリでもOKなはず。
だって、Cのルートディレクトリから検索とか掛けてみたから。
とりあえず、試してみそ〜。
上下前次1-新書関写板覧索設栞歴
あと 340 ﾚｽあります
ｽﾚ情報 赤ﾚｽ抽出 画像ﾚｽ抽出 歴の未読ｽﾚ AAｻﾑﾈｲﾙ
ぬこの手 ぬこTOP 0.007s