変数の名前付けについて

Question

以下のように変数名と値が同じだと微妙だと先輩から言われましたが、どうして微妙なのでしょうか？
良い変数名にするにはどのような変数名を付ければいいのでしょうか？

set go = "go"
set back = "back"

Answer 1

この情報だけでは何とも言いがたいです。
問題ない場合もあるだろうし、問題ある場合もあるだろうし。
注意されたと言うことは、問題があったのではないでしょうか。

Answer 2

私もプログラミング初心者なので回答するのは少し気が引けますが、一般的に、良い変数名というのはそれがどういうデータなのか説明しているということだと言えそうです。

例えば、以下のコードはwikipediaからの引用です。

a = b * c  

weekly_pay = hours_worked * pay_rate

上記の例だと同じことをやっていますが、明らかに下のコードの方がわかりやすいと思います。なぜならそれがどういうデータなのか説明しているから。

ただし、変数のスコープが狭い、すなわちその変数をその箇所でしか使わないのであれば、かえって分かりにくく、冗長になるということもあります。以下のコードはJavaScriptですが言語はなんでもいいです。

for (let i = 0; i < 10; i++) {
  console.log(i);
}

// ↓ 冗長なコード

for (let variable_for_iteration = 0; variable_for_iteration < 10; variable_for_iteration++) {
  console.log(variable_for_iteration);
}

上記の例ではループ用変数は一般的にiを使うというのが慣習になっていますし、わざわざ長ったらしい変数名をつける必要はないかと思います。

変数の命名規則というのは好みというのもあるので、宗教論争になりがちです。ただ、一般論として良い変数名というのはそれがどういうデータなのか説明しているということは言えそうです。

質問者さんの示したコードが"微妙"かどうかは詳しい状況を知らないのでなんとも言えませんが、
会社や上司にこういう命名規則に従えと言われていて、それが良い命名規則じゃなかったとしても従っておく方が無難かと思われます。

参考文献

Comments

[退会済みユーザー]

ご回答ありがとうございます。