コーディング規約 第2条
■ このスレッドは過去ログ倉庫に格納されています
0361デフォルトの名無しさん
NGNG>そういう場合はコメントが不要なようにコードを書き直すべきでないかい?
それ大事。
'データチェック
'もしもデータが正しければ
If DataCheck(Data) = False Then
とか書かれると、 DataCheckの中を見ないと安心できない。どうしても
「正しいときにFalseなのか?」と思ってしまう。場合によりけりだからなおさら。
ここは
If IsValid(Data) Then
みたいに書いてもらえれば(これだとFalseの意味が逆転してるが)
コメントがいらなくなる。
よく考えるとコメントって、コンパイラがチェックしてくれないから
ある意味バグの温床というか可読性を下げかねない諸刃の剣なんだよな。
あと、いわゆる関数ヘッダなんかをコピペで量産することがあるけど
なぜか「'プロシージャ名: IsVarid」とか「戻り値: Boolean型」とか
おまえヘッダでコードの繰り返し書いてどうするよ、このフォーマット
考えた馬鹿はドイツだよ、っていうヘッダをよく見ませんか?
こういうコピペコメントは本人のコメント作成能力を量的に超えている
ことがあるから、そうなると簡単に放置によるコードとの食い違いが
起こるんだよな。
■ このスレッドは過去ログ倉庫に格納されています