0.はじめに
プログラミング初心者は必ず読むべきとも、言われている良書「リーダブルコーディング」を読み、要約をチェックリストとして残していく。
この記事を見直せば、誰でも読みやすく現場でも評価されるようなコードを書けるようにしたい。
読み進める度、更新していきます。
第1部|表面上の改善
変数やクラス名などの付け方などについて
チェックリスト
-
情報を含まない名前を使用していない(スコープが短い(使用される行数が短い)一部の名前を除く)
-
ループイテレーター(ブロックメゾットなどで使われるi,j,kなど)は、意味のある名前を使用している
-
定数やグローバル変数は長くても分かりやすい名前をつけているか
-
大文字やアンダースコア、キャメルスタイルなどはフォーマット規約に乗っ取っているか
-
名前が他の意味に捉えられることはないだろうか(何度も自問自答したか?)
-
限界値を明確にするためにMAXやMINを使う
-
範囲を指定するときはfirstとlastを使う
-
含包・排他的範囲(どこからどこまで的な表現)にはbeginとendを使う
-
ブール値(true or falseを返す値)は文字の最初に動詞を持ってくると良い、
否定系はわかりづらいので避ける