プログラミングで変数名や関数名のネーミングに迷ったときに便利なカンニングペーパーまとめ

2015/3/11 WEB制作

僕は、プログラムをする上で変数や関数に良い名前を付けるのはとても重要と考えています。

というのも、良い名前を付ければ、それだけでそのコードがしたいことの説明になり、コメントと同等の働きをすることもあるからです。

自分がちゃんとそれをできているのかはさておき、僕は普段から、できれば読みやすくて分かりやすい名前を付けたいと思っています。他の人も読むコードであれば、できればプログラムでよく使われるような単語を利用して書いた方がより分かりやすいです。

ただ、よい名前を考えるのって、ちょっと面倒くさいんですよね。僕はこれまで、英語の辞書を利用して、考えたりしていたのですが、「何か、プログラムでよく使われる単語をまとめたものはないか？」と探したら、ドンピシャのものがいくつかあったので、それらをまとめて以下で紹介します。

photo by Michael Coté

codic

codic – デベロッパーのためのネーミング辞書

プログラマーやシステムエンジニアのためのネーミング辞書です。

変数名、関数名はもとより、データベースのカラム名やプログラムのクラス名･メソッド名といったネーミング作業を、手軽に行うための和英辞書といった感じです。

日本語で検索すると、プラグラムなどでよく使われている英単語が以下のようにリストアップされます。（※以下は「取得する」で検索した結果）

単語をクリックすると、詳しいニアンスについて説明するダイアログが出ます。

例えば、通常何かを取得する関数名などは、get_page_title()みたいに書くことも多いかもしれません。けれど、これだとタイトルを、設定値からとるのか、データベースからとるのか、インターネットから取ってくるのか分かりません。

けれど、ネットを介して取ってくるのであればfetch_page_title()とした方が、「行って取ってくる」というニュアンスがあるので、「ネットを介して取ってくるのだな」ということがわかりやすくなります。加えて、処理コストの高い（時間のかかる）関数ということも何となく伝わるので、誤って乱用してしまうことも防げます。

と、こういったプログラムに利用する英単語を手軽に検索することができる辞書ツールです。今更なのかもしれませんが、僕は今回の調べものをしていて初めて知りました。

プログラミングのネーミングに特化した開発者ブログも、とても勉強になります。