第3章:誤解されない名前

概要

本章のメインテーマは、「誤解される名前に気をつけろ」です。誤解されないようにするために、「名前が他の意味と間違えられないだろうか？」ということを自問自答すべきであることを伝えている。

まとめ

最善の名前とは、「自分が書いたコードを読む人が自分のいとを正しく理解してくれる名前」である。つまり、誤解されない名前である。そのような名前を命名するためには、反対の立場、あるいは批判的な立場に立って誤解されない名前であるかを考える必要があるし、それを習慣化させる必要がある。

学んだ点

・誤解(他人との認識の相違になりそうな危うい命名)をできる限りでさける必要性があること
・fillerという文字を使いがちだが、「選択する」なのか「除外する」なのかわからない曖昧な単語である。selectやexclude等のより具体的な単語を用いることがベターである。
・命名する際は、場合に応じて単位等を活用すると理解しやすい命名ができる。
・限界値を決めるときは、「max」「min」を使用する。
・範囲を指定するときは、「firsr」「last」を使用する。
・包含/排他的範囲には、「begin」「end」を使用する。(英語には、ちょうど値を超えた時を表す簡潔な単語がないらしいです。)
・ブール値の変数やブール値を返す関数の名前を選ぶときんは、trueやfalseの意味を明確にする必要がある。
・ユーザーの期待に合わせる。

感想と振り返り

自分自身が変数命名する時、周りにある似たような属性？の変数を参考にして命名しています。しかし、その開発環境では、適した名前であることはしばしあっても、別のプロジェクトにアサインされた場合に、その潰し的な考えが効かないかもしれないので、変数に命名する際は常に「他人から見て自分の意図が正しく理解されるか？」ということを念頭に置きたいと思います。すでに存在する変数の名前もより正しい命名方法があるのでは？のような考えも持っておきたいですね！