名前が適切か問題
コーディングをしていていつも悩むのが,この変数名/関数(メソッド)名/クラス名で良いのだろうか?という問題
日本語分かる人しかいない!と開きなおって日本語名を付けてしまうのも,状況によってはアリだとは思いますが,先のことは分からないのでなるべく英語でそれっぽい名前付けをしておきたいものです.
とはいっても細かいニュアンスとかわからないし,そもそも語彙が少ないので毎度辛い思いをしてるので,自分はこんな感じでやろうとしてるというまとめ.
名前をぼやっと考える
たとえば初期化処理に名前をつけようとすると,だいたいinit
とかinitial
とか出てきちゃうわけですが,どれもこれも同じように命名すると余計にわかりにくくなってしまいます.
そこでおもむろに,Thesaurus.com で類語を検索
http://www.thesaurus.com の良いところは,意味が似ているものの順に色付けしてくれる点
また,反意語も同時に出してくれるので,対称性のあるメソッドを作りたいときなどは参考になります.
選んだ単語の用例を知る
単語が分かっても適切な使い方(文法や慣例など)をしなければ余計にわかり辛くなってしまうもの.
そこで,英辞郎で検索
普通の辞書と違うところは,用例が豊富に出てくるところ.
用例がより多く出てくる = 頻繁に(より一般的に)使われているはず なので,単語選びのために http://www.thesaurus.com と行ったり来たりしながらよりしっくりくる単語を選びます.
名前をつける
あとはもう...勘です.
英辞郎をはさむことで,明らかに一般的じゃなさそうな単語は避けることができます(主観)し,語彙も増えていってる気がするとかしないとか.
あとは...接続詞(at
とかon
とかby
とか...)には気をつけたいところですが,なかなか適切なものを選ぶのは難しいですね.