独学でDelphiを勉強しています。
参考となるソースコードを見ながら勉強しているのですが、Delphiでコードを書く際、
誰が見ても分かりやすく綺麗で、そのコードの内容を理解できるような書き方を身に付けたいです。
標準的な書き方のルールはあるのでしょうか。(コメントの書き方など)
もしありましたら教えてください。
リーダブルコード
https://www.oreilly.co.jp/books/9784873115658/
が良いかもしれません。
(ただ、例示されているコードは、Delphiじゃないですが・・)
英語ですが
Delphi’s Object Pascal Style Guide - RAD Studio
https://docwiki.embarcadero.com/RADStudio/Athens/en/Delphi%E2%80%99s_Object_Pascal_Style_Guide
個人的な意見ですが、
・どのような状況でも同じ書きかたで一貫性を保つ
・自分のコードも他人のコードも同じように見る/読む(自分のコードも1カ月経てば他人のコード)
・警告もヒントも残さない
・Gitなどを使うことで、不要になったコードをコメントとして残さない(Gitはローカルでも構わない)
明確なルールというわけではありませんが
コード補完で出てくるソースコードはメーカーが望んでいる書き方なのかなぐらいには思います
書き方ではありませんが自分の場合
with は使わない
ソースコード1行は画面内に収まる長さとする
関数自身の行もできる限り画面内に収まる行数とする
とりあえず作っただけの関数でもコメント1行で何をしてるのかぐらいは書く
ぐらいでしょうか?
ある程度の段階までは書き方のルールが見えてこないDelphiですが
オブジェクト指向を学ぶ段階になると突然暗黙のルールがたくさん出てきますのでご注意を